home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 1 / The Arsenal Files (Arsenal Computer).ISO / os2_app / cmoverv.inf (.txt) < prev    next >
OS/2 Help File  |  1993-10-27  |  107KB  |  3,436 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. Communications Manager provides services that your workstation can use to 
  5. communicate with a host computer or another workstation.  You can use 
  6. Communications Manager applications to exchange information or use resources 
  7. from the host or from other workstations.  These resources include programs, 
  8. files, databases, and printers. 
  9.  
  10. Communications Manager allows your workstation to: 
  11.  
  12. o Communicate with host computers or other workstations either directly or 
  13.   through any of the following kinds of networks: 
  14.  
  15.    - Local area networks (LANs) 
  16.  
  17.    - Systems Network Architecture-conforming networks 
  18.  
  19.    - Integrated services digital network (ISDN) 
  20.  
  21.    - X.25 networks 
  22.  
  23. o Control the method of data exchange between your workstation and a host 
  24.   computer or another workstation that uses different kinds of communications 
  25.   protocols or techniques, such as Synchronous Data Link Control (SDLC), X.25, 
  26.   or asynchronous communications 
  27.  
  28. o Be configured remotely by any computer running Communications Manager over a 
  29.   network 
  30.  
  31. o Emulate, or perform like, a 3270 or 5250 display terminal when communicating 
  32.   with a host computer 
  33.  
  34. o Use the services of the Presentation Manager* interface, such as the 
  35.   clipboard, online help, and emulator help 
  36.  
  37. o Transfer files to and from a host computer or another workstation 
  38.  
  39. o Use host-directed printing features 
  40.  
  41. o Remap, or change, keyboard definitions for the OS/2 3270/5250 emulator. 
  42.  
  43. *  Trademark of IBM. 
  44.  
  45.  
  46. ΓòÉΓòÉΓòÉ 2. What's New ΓòÉΓòÉΓòÉ
  47.  
  48. Communications Manager/2 Version 1.1 contains the following new functions: 
  49.  
  50. o An enhanced OS/2 3270/5250 emulator, including: 
  51.  
  52.    - A Menu Bar to access emulator functions 
  53.  
  54.    - Hide/Show and Popup Menu Bar options on the System Menu 
  55.  
  56.    - New emulator functions, including: 
  57.  
  58.       o New file transfer functions permitting multiple file transfers and host 
  59.         selection with pull-down menus. 
  60.  
  61.       o Automatic Font Selection 
  62.  
  63.       o Hotspots for host mouse functions 
  64.  
  65.       o Popup Keypad 
  66.  
  67.       o Numeric Lock Field 
  68.  
  69. o Double-byte character set support for the OS/2 3270/5250 emulator. 
  70.  
  71. o A Communications Manager/2 Distributed Feature that allows you to run 
  72.   Communications Manager from a redirected drive. 
  73.  
  74. o The capability to support transactions in full-duplex mode in an LU 6.2 
  75.   environment. 
  76.  
  77. o Support for Integrated Data Link Control (IDLC) 
  78.  
  79. o Support for SNA session level data compression 
  80.  
  81. o The capability of connecting to an unlimited number of hosts concurrently 
  82.  
  83. o The capability that all workstations running OS/2 on a LAN segment have 
  84.   access to NetView*. 
  85.  
  86. o The capability for downstream Novell** NetWare** users to use Communications 
  87.   Manager as a gateway to exchange network management data between themselves 
  88.   and NetView* running on the host. 
  89.  
  90. o The capability to issue Communications Manager system management commands 
  91.   from the OS/2 command line to obtain and display information about links, 
  92.   data-link control, and APPC transactions. 
  93.  
  94. o The capability to route RUNCMDs from an OS/2 service point to an OS/2 
  95.   workstation. 
  96.  
  97. o Expanded use of First Failure Support Technology (FFST/2) to perform problem 
  98.   determination functions. 
  99.  
  100. o Expanded formatted trace service, to include more APIs, such as SRPI, 
  101.   EHLLAPI, LUA, and ACDI. 
  102.  
  103. *  Trademark of IBM. 
  104.  
  105. **  Trademark of Novell, Inc. 
  106.  
  107.  
  108. ΓòÉΓòÉΓòÉ 2.1. Communications Manager/2 Distributed Feature ΓòÉΓòÉΓòÉ
  109.  
  110. The CM/2 Distributed Feature has the capability to share a common set of files 
  111. among multiple users. This requires only a small amount of Communications 
  112. Manager product files to be stored on your workstation.  The rest of the 
  113. product files are stored on a file server on the same LAN. The distributed 
  114. workstations have many, but not all, of the functions of the single user 
  115. workstations. 
  116.  
  117. Following are some of the services the CM/2 Distributed Feature supports: 
  118.  
  119. o 3270 and 5250 emulation over LAN connections 
  120. o APPC, CPI Communications, and LUA APIs over LAN connections 
  121. o ACDI redirection over LAN connections 
  122. o ACDI API over an asynchronous connection 
  123.  
  124. Following are some of the services the Communications Manager/2 Distributed 
  125. Feature does not support: 
  126.  
  127. o Synchronous data link control (SDLC) 
  128. o Integrated Data Link Control (IDLC) 
  129. o Twinaxial data link control (TDLC) 
  130. o X.25 DLC 
  131. o Gateway 
  132. o Network node 
  133. o Ability to create and maintain configurations 
  134.  
  135. See the Network Administration and Subsystem Management Guide for more 
  136. information on the CM/2 Distributed Feature. 
  137.  
  138. See the Workstation Installation and Configuration Guide for more information 
  139. on installing and configuring the CM/2 Distributed Feature. 
  140.  
  141.  
  142. ΓòÉΓòÉΓòÉ 3. Services and Connections ΓòÉΓòÉΓòÉ
  143.  
  144. Communications Manager supports a variety of services and connections 
  145. including: 
  146.  
  147. Services 
  148.  
  149. o Advanced Peer-to-Peer Networking* (APPN*) 
  150.  
  151. o Advanced program-to-program communications (APPC) 
  152.  
  153. o Asynchronous communications device interface (ACDI) 
  154.  
  155. o Subsystem management 
  156.  
  157. o Systems application architecture* (SAA*) common communications support 
  158.   architectures 
  159.  
  160. o Systems network architecture (SNA) gateway 
  161.  
  162. o User Profile Management 
  163.  
  164. o Novell** NetWare** support 
  165.  
  166. o FFST/2* support 
  167.  
  168. Connections 
  169.  
  170. o Local Area Network (LAN) Support Services 
  171.  
  172. o Integrated services digital network (ISDN) 
  173.  
  174.    - IDLC 
  175.    - SDLC 
  176.    - X.25 
  177.    - LAN (IEEE 802.2 and NetBIOS) 
  178.  
  179. o X.25 network 
  180.  
  181. o Coaxial distributed function terminal (DFT) 
  182.  
  183. o Synchronous data link control (SDLC) nonswitched and switched line support 
  184.  
  185. o Twinaxial data link control (TDLC) 
  186.  
  187. *  Trademark of IBM. 
  188.  
  189. ** Trademark of Novell, Inc. 
  190.  
  191.  
  192. ΓòÉΓòÉΓòÉ 3.1. Advanced Peer-to-Peer Networking (APPN)* ΓòÉΓòÉΓòÉ
  193.  
  194. Communications Manager provides Advanced Peer-to-Peer Networking (APPN) 
  195. end-node and network-node support for workstations, allowing them more 
  196. flexibility communicating with other systems in the network. Some of the 
  197. important capabilities that APPN provides are: 
  198.  
  199. o End-node capability, which allows the local node, such as a workstation, to 
  200.   connect as an end node to a serving network node for directory and routing 
  201.   services. 
  202.  
  203. o Network-node capability, which provides network services on behalf of 
  204.   connected end nodes. 
  205.  
  206. o Connection network services for the LAN, which workstations use to obtain LAN 
  207.   destination addresses without having to be configured for them.  This 
  208.   capability allows a node to establish a link connection directly to another 
  209.   node with no LAN destination address configured. 
  210.  
  211. * Trademark of IBM 
  212.  
  213.  
  214. ΓòÉΓòÉΓòÉ 3.2. Advanced Program-to-Program Communications (APPC) ΓòÉΓòÉΓòÉ
  215.  
  216. Communications Manager supports APPC between SNA applications, allowing 
  217. workstations to share programs, files, and other data.  Communications Manager 
  218. also supplies an APPC API for writing application programs. 
  219.  
  220. APPC supports conversation and session security between communicating programs. 
  221. You can manage this security through User Profile Management Services. 
  222.  
  223. Communications Manager also supports data compression for APPC communications. 
  224.  
  225.  
  226. ΓòÉΓòÉΓòÉ 3.3. Asynchronous Communications Device Interface (ACDI) ΓòÉΓòÉΓòÉ
  227.  
  228. Communications Manager supports asynchronous communication for applications 
  229. written to the ACDI or ACDI Redirection API. This includes: 
  230.  
  231. o Direct asynchronous communications from the workstation 
  232.  
  233. o Redirected asynchronous communications through a LAN server that has the IBM* 
  234.   Local Area Network Asynchronous Connection Server (LANACS) installed. 
  235.  
  236. *Trademark of IBM. 
  237.  
  238.  
  239. ΓòÉΓòÉΓòÉ 3.4. Coaxial Distributed Function Terminal (DFT) ΓòÉΓòÉΓòÉ
  240.  
  241. Communications Manager supports coaxial DFT, which is the protocol used for 
  242. communication through an IBM 3274 or IBM 3174 control unit. 
  243.  
  244. Communications Manager also supports the 3270 credit card adapter. 
  245.  
  246.  
  247. ΓòÉΓòÉΓòÉ <hidden> 3270 Credit Card Adapter ΓòÉΓòÉΓòÉ
  248.  
  249. The 3270 emulation credit card adapter is a credit card size adapter that 
  250. provides an interface between computer systems and 3270 networks. The 3270 
  251. credit card emulates a 3270 session in DFT and is designed for use with 
  252. Personal Computer Memory Card International Association (PCMCIA) version 2.0, 
  253. type 2 slots. 
  254.  
  255. When you choose to use this option, the 3270 emulation is configured to use a 
  256. 3270 credit card for communication.  If a 3270 credit card is not installed, 
  257. the 3270 emulator looks for a 3270 connection adapter, a 3278/79 emulation 
  258. adapter, or an advanced 3278/79 emulation adapter for communication. 
  259.  
  260. Note:  There is no support for LAN over Coaxial (DFT).  The existing DFT 
  261.        limitation of 5 sessions remains unchanged.  This support is for OS/2 
  262.        V2.1 and higher. 
  263.  
  264.  
  265. ΓòÉΓòÉΓòÉ 3.5. Integrated Data Link Control (IDLC) ΓòÉΓòÉΓòÉ
  266.  
  267. IDLC is a full-duplex high-level data link control (HDLC) protocol. It is IBM's 
  268. implementation of the CCITT Q.922 standard or Link Access Procedure-Extended 
  269. (LAPE).  IDLC can support point-to-point workstation connections over a 
  270. full-duplex wide area network (WAN). 
  271.  
  272. In some cases, IDLC refers to Integrated Services Digital Network (ISDN) data 
  273. link control.  It has the same function as integrated data link control, but it 
  274. is used by ISDN.  The Communications Manager implementation of IDLC supports 
  275. not only the ISDN B-channel, but also supports any point-to-point WAN 
  276. connection. 
  277.  
  278. IDLC is supported by the AS/400 and the 3174 Communication Controller for an 
  279. ISDN connection. 
  280.  
  281.  
  282. ΓòÉΓòÉΓòÉ 3.6. Integrated Services Digital Network (ISDN) ΓòÉΓòÉΓòÉ
  283.  
  284. ISDN is a technology for transferring data over a switched digital 
  285. telecommunication network.  This ability provides a fast and reliable way for 
  286. transferring or sharing information between remotely attached machines. 
  287. Because several users can share the same circuits within the switched network, 
  288. the network needs a protocol to manage the communication links. 
  289.  
  290. The recommendations of the International Telegraph and Telephone Consultative 
  291. Committee (CCITT) define such a protocol for attaching equipment (for example, 
  292. a workstation) to an ISDN.  Communication Manager's switched network 
  293. environment, along with the IBM ISDN interface coprocessor adapters and the IBM 
  294. ISDN Coprocessor Support Program Version 1.2 software, supports this protocol 
  295. and its variations specific to certain network implementation worldwide. 
  296.  
  297. Communications Manager supports the basic rate interface to an ISDN. This 
  298. interface provides circuit switch or packet mode access on two independent 64 
  299. kilobits per second (Kbps) data channels (referred to as B-channels).  It also 
  300. provides a 16 Kbps signaling channel (referred to as the D-channel).  The 
  301. D-channel is mainly used for signaling but it can also be used for X.25 packet 
  302. data communications. 
  303.  
  304. To enable Communications Manager ISDN support, the following software must be 
  305. installed and configured in the following order: 
  306.  
  307. o LAPS (NTS/2 level required) 
  308.  
  309.   If you are not using LAN protocols, install using the LAPS /N command. This 
  310.   provides PROTMAN.OS2, NETBIND.EXE and PROTOCOL.INI. 
  311.  
  312. o IBM ISDN Coprocessor Support Program Version 1.2 
  313.  
  314.   This provides the software support for the adapter and NETWORK.INI. 
  315.   NETWORK.INI provides network-specific information to Communications Manager. 
  316.  
  317. o Communications Manager/2 Version 1.1 
  318.  
  319.  
  320. ΓòÉΓòÉΓòÉ 3.7. Local Area Network (LAN) Support ΓòÉΓòÉΓòÉ
  321.  
  322. LAN Adapter and Protocol Support (LAPS) is a prerequisite for Communications 
  323. Manager.  IBM Network Transport Services/2 (NTS/2) provides the support for IBM 
  324. LAN adapters and a range of certified non-IBM LAN adapters for the following 
  325. types of LANs: 
  326.  
  327. o IBM Token-Ring Network 
  328.  
  329. o IBM PC Network 
  330.  
  331. o Ethernet (ETHERAND) Network 
  332.  
  333. o IBM 3174 Peer Communications Network 
  334.  
  335.  
  336. ΓòÉΓòÉΓòÉ 3.8. NetWare Support ΓòÉΓòÉΓòÉ
  337.  
  338. Communications Manager provides the ability to use either Communications 
  339. Manager or NetWare as a gateway to exchange network management data between 
  340. themselves and NetView* running on a host. This requires that you have a 
  341. Communications Manager workstation and Novell** NetWare** for SAA* server on a 
  342. LAN.  With this configuration, Communications Manager supports SNA Management 
  343. Services transport between: 
  344.  
  345. o A Communications Manager workstation and NetView through an intermediary 
  346.   NetWare for SAA server 
  347.  
  348. o A NetWare for SAA server and NetView through an intermediary Communications 
  349.   Manager workstation 
  350.  
  351. *  Trademark of IBM. 
  352.  
  353. ** Trademark of Novell, Inc. 
  354.  
  355.  
  356. ΓòÉΓòÉΓòÉ 3.9. Subsystem Management ΓòÉΓòÉΓòÉ
  357.  
  358. Communications Manager provides subsystem management to allow you to display 
  359. and control the running status of the links, sessions, and transaction programs 
  360. (TPs) operating on your system.  You can fine-tune the operation of your 
  361. network by displaying the status of these resources and using subsystem 
  362. management functions to alter communication session operations. As you take 
  363. these actions, subsystem management continues to monitor the real-time activity 
  364. of your sessions and the links on which they are operating.  As a result, you 
  365. can immediately see how an action you take on one resource affects the 
  366. operation of others. 
  367.  
  368. In the Subsystem Management window you can: 
  369.  
  370. o View the status of the Communications Manager services that are listed in the 
  371.   window. 
  372.  
  373. o Viewing the status of Communications Manager services 
  374.  
  375. o Use the menu bar in the window to start or stop many of the listed services. 
  376.  
  377. o Starting and stopping Communications Manager services 
  378.  
  379. o Use the menu bar to display the status of your network resources (links, data 
  380.   link controls (DLCs), and sessions). When you open the display windows, you 
  381.   can start or stop activity on many of the displayed resources. 
  382.  
  383. o Displaying and controlling sessions and links 
  384.  
  385.  
  386. ΓòÉΓòÉΓòÉ <hidden> Viewing the Status of Communications Manager Services ΓòÉΓòÉΓòÉ
  387.  
  388. The Subsystem Management window displays a list of the names of the services 
  389. that can be displayed or controlled within subsystem management. The status 
  390. field next to the name of a service tells you whether the service is currently 
  391. Starting, Started, Stopping, or Stopped within the active configuration. 
  392.  
  393. The fields at the top of the window display the names of the active 
  394. configuration (the configuration that is currently running) and the default 
  395. configuration (the configuration that Communications Manager uses when you 
  396. first start the program on your workstation). 
  397.  
  398.  
  399. ΓòÉΓòÉΓòÉ <hidden> Starting and Stopping Communications Manager Services ΓòÉΓòÉΓòÉ
  400.  
  401. You can use the pull-down menu in the Subsystem Management window to start and 
  402. stop the following services: 
  403.  
  404. o APPC (advanced program-to-program communication) attach manager 
  405.  
  406. o Communications Manager kernel 
  407.  
  408. o SNA (systems network architecture) subsystem 
  409.  
  410. Note:  Some of these services may not appear in the Subsystem Management window 
  411. on your workstation.  The services displayed in the window vary by the type of 
  412. workstation configuration you are using. 
  413.  
  414.  
  415. ΓòÉΓòÉΓòÉ <hidden> Keylock ΓòÉΓòÉΓòÉ
  416.  
  417. The Communications Manager keylock is a software security function that serves 
  418. two purposes: 
  419.  
  420. o Protects confidential information that could be exposed by some 
  421.   Communications Manager functions, such as trace and configuration. 
  422.  
  423. o Prevents unauthorized or accidental changes to a configuration. 
  424.  
  425. If you need access to keylocked functions, your system administrator can give 
  426. you the password. 
  427.  
  428.  
  429. ΓòÉΓòÉΓòÉ <hidden> Displaying and Controlling Sessions and Links ΓòÉΓòÉΓòÉ
  430.  
  431. You can use the Subsystem Management window to display the status of individual 
  432. communication sessions and the links on which they operate. 
  433.  
  434. SNA Networks 
  435.  
  436. To display the status of sessions and links on a Systems Network Architecture 
  437. (SNA) network, select SNA subsystem; and then select Service from the menu bar. 
  438. Select Details from the Service pull-down menu.  The SNA Subsystem window 
  439. appears, from which you can choose which resources you want to display or 
  440. control. 
  441.  
  442. In many cases, when you open a display window, you can use the pull-down menu 
  443. on the window to start, stop, or modify the activity of the individual 
  444. resources displayed. 
  445.  
  446. X.25 Networks 
  447.  
  448. To display the status of physical links or SNA virtual circuits on an X.25 
  449. network, select your choice on this window; and then select Service from the 
  450. menu bar.  Select Details from the Service pull-down menu. 
  451.  
  452. When you open a display window, you can use the menu bar on the window to 
  453. start, stop, or modify the activity of the individual resources displayed. 
  454.  
  455. Note:  X.25 selections appear only when X.25 physical links and SNA virtual 
  456. circuits are defined in your configuration. 
  457.  
  458.  
  459. ΓòÉΓòÉΓòÉ 3.10. SAA Common Communications Support Architectures ΓòÉΓòÉΓòÉ
  460.  
  461. Communications Manager implements Systems Network Architecture/Management 
  462. Services (SNA/MS). This architecture defines the approach to managing 
  463. communications networks. The protocols used offer a vehicle for monitoring 
  464. network operations from a central location. 
  465.  
  466.  
  467. ΓòÉΓòÉΓòÉ 3.11. Synchronous Data Link Control (SDLC) Nonswitched and Switched Line Support ΓòÉΓòÉΓòÉ
  468.  
  469. Communications Manager supports SDLC nonswitched line support, which is a 
  470. communications protocol for managing information transfer over a 
  471. telecommunications line that does not require dialing to establish the 
  472. connection. 
  473.  
  474. Communications Manager also supports SDLC switched, which does require dialing 
  475. to establish the connection. 
  476.  
  477.  
  478. ΓòÉΓòÉΓòÉ 3.12. Systems Network Architecture (SNA) Gateway ΓòÉΓòÉΓòÉ
  479.  
  480. Communications Manager allows multiple users on a LAN, an SDLC switched or 
  481. leased link, an X.25 network, or ISDN network to access a System/370* (S/370) 
  482. architecture host through an SNA gateway. Up to 254 workstations can be 
  483. configured on the LAN supported by the SNA gateway. 
  484.  
  485. A gateway permits communication between hosts that support PU 2.0 workstations 
  486. and workstations that use different DLC types.  An SNA gateway can do the 
  487. following: 
  488.  
  489. o Act as a protocol converter between workstations that use DLCs on their links 
  490.   that are different from the DLC that is used on the host link 
  491.  
  492. o Reduce the amount of system definition at the host and workstations 
  493.  
  494. o Allow you to dynamically change network definitions and add workstations 
  495.  
  496. o Reduce host resources by using pooled LUs, and by automatically logging off 
  497.   unused sessions 
  498.  
  499. * Trademark of IBM Corporation 
  500.  
  501.  
  502. ΓòÉΓòÉΓòÉ 3.13. Twinaxial Data Link Control (TDLC) ΓòÉΓòÉΓòÉ
  503.  
  504. Communications Manager supports twinaxial data link control (TDLC), which is a 
  505. communications function that allows workstations attached to a workstation 
  506. controller by way of twinaxial cable to use 5250 emulation and APPC. 
  507.  
  508. Note:  5250 emulation for twinaxial connection is for an IBM Applications 
  509. System/400* (AS/400*) only. 
  510.  
  511. *  Trademark of IBM. 
  512.  
  513.  
  514. ΓòÉΓòÉΓòÉ 3.14. User Profile Management (UPM) Services ΓòÉΓòÉΓòÉ
  515.  
  516. User Profile Management lets you control access to shared resources, such as 
  517. file systems and databases. You can use UPM to create, manage, and view 
  518. individual and group user IDs as well as to set authority levels. 
  519.  
  520. In Communications Manager, advanced program-to-program communications (APPC) 
  521. and 5250 emulation use UPM to control access to remote computers by requiring 
  522. users to log on at the UPM logon window. 
  523.  
  524. The User's Guide contains information about administering and using UPM.  In 
  525. addition, the online Command Reference contains descriptions and syntax for UPM 
  526. commands that you can type from the OS/2 command line. 
  527.  
  528.  
  529. ΓòÉΓòÉΓòÉ 3.15. X.25 Network Support ΓòÉΓòÉΓòÉ
  530.  
  531. Communications Manager supports communications over X.25 packet switching data 
  532. networks (PSDNs) using either permanent or switched virtual circuits.  SNA 
  533. applications can use this connection through the qualified logical link control 
  534. (QLLC). The complete data traffic from all the sessions on an SNA link can be 
  535. carried over a single virtual circuit. 
  536.  
  537. In addition, an API for non-SNA communications is provided so that a single 
  538. X.25 link can carry a mixture of multiple SNA and non-SNA virtual circuits 
  539. concurrently. X.25 is supported within SAA common communications protocol. 
  540.  
  541.  
  542. ΓòÉΓòÉΓòÉ <hidden> Connecting to Multiple Hosts ΓòÉΓòÉΓòÉ
  543.  
  544. Communications Manager provides the ability to communicate to multiple hosts 
  545. (SSCPs) on separate logical links through unique physical unit (PU) 
  546. connections.  This can be useful in the following situations: 
  547.  
  548. o LU 6.2 access to public networks (for example, X.25) of hosts that have not 
  549.   installed VTAM* 3.2 or later, and that cannot establish cross-domain links 
  550.  
  551. o LU 0, 1, 2, or 3 access to hosts in different domains, where cross-domain 
  552.   configuration is not possible 
  553.  
  554. o Direct routes to multiple hosts when this is more efficient than a route 
  555.   through cross-domain links 
  556.  
  557. o Multiple links to the same host for gateway configurations that require more 
  558.   than 254 dependent host LUs 
  559.  
  560. * Trademark of IBM 
  561.  
  562.  
  563. ΓòÉΓòÉΓòÉ <hidden> Managing 3270 and 5250 Sessions ΓòÉΓòÉΓòÉ
  564.  
  565. Communications Manager provides a way for you to view a list of configured 
  566. emulator sessions and to start and stop those sessions. 
  567.  
  568.  
  569. ΓòÉΓòÉΓòÉ 4. Emulation ΓòÉΓòÉΓòÉ
  570.  
  571. Communications Manager allows your workstation to emulate, or perform like, a 
  572. 3270 or 5250 host display terminal, and to establish host printer sessions with 
  573. a workstation printer. The type of emulation (3270 or 5250) depends on the type 
  574. of host computer you are communicating with.  An individual workstation can be 
  575. connected to multiple hosts and perform both types of emulation. 
  576.  
  577. These connections, called emulation sessions, allow you to have access to host 
  578. computer functions as if you were using a 3270 or 5250 host display terminal. 
  579.  
  580. 3270 and 5250 emulation sessions are managed through Presentation Manager 
  581. windows.  As a result, you can change the color, size, and location of an 
  582. emulator session window on your screen.  You make these changes either during 
  583. configuration, or during runtime through the Menu Bar. 
  584.  
  585. The Menu Bar gives you access to a variety of emulator user functions, 
  586. including: 
  587.  
  588. o File transfer to and from host systems 
  589.  
  590. o Host graphics capabilities 
  591.  
  592. o Keyboard remapping 
  593.  
  594. o Color customizing of emulator session screens 
  595.  
  596. o Font size customizing 
  597.  
  598. o Pop-up Keypad function 
  599.  
  600. o Hotspots for mouse usage in emulation sessions 
  601.  
  602. o Numeric Lock function 
  603.  
  604.  In addition, the Menu Bar gives you access to a number of OS/2 features such 
  605. as Clipboard and print screen functions. Each emulation session appears in its 
  606. own window. All printer sessions appear in a print control window. 
  607.  
  608. Depending on the connections configured for your workstation, you can start: 
  609.  
  610. o 5 coaxial terminal or printer 3270 sessions 
  611. o 16 active display sessions for 3270 (For OS/2 2.1, the limit of active 
  612.   display sessions is increased to 26.) 
  613. o 15 terminal or printer 5250 sessions 
  614.  
  615. You can start up to 26 sessions concurrently, combining 3270 and 5250 terminal 
  616. emulations and printer sessions. 
  617.  
  618. Communications Manager supports data compression for 3270 and 5250 emulation 
  619. session communications. 
  620.  
  621. The types of connections used for your sessions are shown in the 3270/5250 
  622. Session Management window.  Your system administrator can tell you about the 
  623. configuration of your workstation and about the session types available to you. 
  624.  
  625.  
  626. ΓòÉΓòÉΓòÉ 4.1. Menu Bar ΓòÉΓòÉΓòÉ
  627.  
  628. The Menu Bar, at the top of your emulator session window, gives you access to a 
  629. variety of emulator user functions.  The Menu Bar selections are File, Edit, 
  630. Transfer, Settings, Keyboard, and Help.  Help is provided for each selection 
  631. and for each of the choices they contain. 
  632.  
  633. The System Menu, in the upper left corner of the emulator screen, contains a 
  634. Hide/Show Menu Bar option, and a Popup Menu Bar option. 
  635.  
  636.  
  637. ΓòÉΓòÉΓòÉ 4.2. File Transfer ΓòÉΓòÉΓòÉ
  638.  
  639. You can send files to a host computer or receive files from a host computer 
  640. using 3270 terminal emulation.  This is called a file transfer.  IBM host 
  641. computers that use VM, TSO, or CICS system software and have the required file 
  642. transfer program installed, support file transfer using 3270 terminal 
  643. emulation. 
  644.  
  645. File transfer uses an emulator session to transfer a file. You must be logged 
  646. on to the emulator session you want to use for the file transfer.  File 
  647. transfer has exclusive use of the session and you cannot interact with the host 
  648. application while file transfer is running. 
  649.  
  650. You can send or receive files either of two ways: 
  651.  
  652. o Using the Transfer function, accessible through the Menu Bar 
  653. o From the OS/2 command prompt 
  654.  
  655. When you transfer files using Send file or Receive file from the Transfer menu 
  656. on the Menu Bar, you specify the file transfer options to be used for the 
  657. transfer.  You can name and save sets of options so that you can use them for 
  658. other file transfer sessions. 
  659.  
  660. You can also transfer multiple files at once by specifying the name of a file 
  661. list you have created.  Even during multiple file transfer each individual file 
  662. can have its own set of file transfer options. 
  663.  
  664. The 5250 emulator does not support file transfer between the workstation and 
  665. the host computer.  However, file transfer is available when you use the PC 
  666. Support programs on AS/400. 
  667.  
  668.  
  669. ΓòÉΓòÉΓòÉ 4.3. Host Graphics ΓòÉΓòÉΓòÉ
  670.  
  671. You can use the Graphical Data Display Manager (GDDM) host graphics support in 
  672. a 3270 emulation session.  GDDM-OS/2 Link file must be installed on your host 
  673. to allow you to download the necessary files to your workstation. 
  674.  
  675. To customize Host Graphics, select Host Graphics from the Settings menu on the 
  676. Menu Bar. 
  677.  
  678. For more information, refer to the Graphical Data Display Manager publications. 
  679.  
  680.  
  681. ΓòÉΓòÉΓòÉ 4.4. Keyboard Remapping ΓòÉΓòÉΓòÉ
  682.  
  683. The Communications Manager keyboard utility enables you to change key 
  684. assignments on the keyboard you use in terminal emulation.  You can customize 
  685. key operations to match the keyboard layout you are accustomed to using. 
  686.  
  687. A keyboard layout is the physical arrangement of the keyboard.  In that layout, 
  688. functions are assigned, or mapped, to keys.  These key assignments are called 
  689. the keyboard mapping.  They are contained in a keyboard profile within a 
  690. Communications Manager configuration file. 
  691.  
  692. Communications Manager provides default keyboard mappings for workstations that 
  693. use terminal emulation.  You can use these defaults or use the keyboard utility 
  694. to change them. 
  695.  
  696. There are two ways to start the keyboard utility program: 
  697.  
  698. o From the Keyboard menu on the Menu Bar 
  699.  
  700. o From the 3270/5250 emulation configuration windows in CMSETUP 
  701.  
  702. Using the keyboard utility, you can: 
  703.  
  704. o Move a definition from a source key to a target key 
  705.  
  706. o Copy a definition from a source key to a target key 
  707.  
  708. o Swap the definitions of a source key and a target key 
  709.  
  710. o Print a copy of the keyboard layout 
  711.  
  712. o Locate keys assigned to a specified function 
  713.  
  714. o Display the current keyboard definitions 
  715.  
  716. o Remap a selected key 
  717.  
  718. A browse function enables you to view the current definitions for each key. 
  719.  
  720.  
  721. ΓòÉΓòÉΓòÉ 4.5. Color Customizing ΓòÉΓòÉΓòÉ
  722.  
  723. The foreground and background colors of the 3270 and 5250 emulation sessions 
  724. are specified during configuration.  You can accept these default colors or 
  725. choose your own. 
  726.  
  727. To choose your own, use the Settings option on the Menu Bar and select Color. 
  728.  
  729. As you select new colors the change is immediately made to the current 
  730. emulation session window. This lets you view the effect of your color changes 
  731. before you save them. 
  732.  
  733.  
  734. ΓòÉΓòÉΓòÉ 4.6. Font Size ΓòÉΓòÉΓòÉ
  735.  
  736. You can change the font size by selecting Settings from the Menu Bar, then 
  737. selecting font size.  The font size you select remains active until it is 
  738. changed. 
  739.  
  740. The Font Size window allows you to perform the following tasks: 
  741.  
  742. o Accept a font size automatically determined by the emulator program 
  743.  
  744. o Select a font size from the list 
  745.  
  746. The fields and buttons specific to this window are: 
  747.  
  748. o Automatic font selection 
  749. o Fixed size 
  750.  
  751. Automatic font selection lets the emulator program automatically assign the 
  752. font size according to the window size. 
  753.  
  754. Fixed size allows you to change the font for data displayed in the emulator 
  755. session window. 
  756.  
  757.  
  758. ΓòÉΓòÉΓòÉ 4.7. Pop-up Keypad ΓòÉΓòÉΓòÉ
  759.  
  760. A popup keypad is a small window containing push buttons, or keys, so that you 
  761. can use your mouse to perform keyboard operations.  Communications Manager lets 
  762. you define two popup keypads, each with eight push buttons. 
  763.  
  764. To display a popup keypad, place your mouse pointer anywhere in the emulator 
  765. session window and click once with mouse button 2. The keypad pops up at the 
  766. mouse pointer position. 
  767.  
  768. The push buttons have default assignments, but you can customize your keypads 
  769. using the Popup Keypad Setup window, which is accessed from the Menu Bar under 
  770. Keyboard. 
  771.  
  772. Use the Popup Keypad Setup window to customize the popup keypads in the 
  773. following ways: 
  774.  
  775. o Change a key assignment on a popup keypad 
  776. o Display the current settings of a popup keypad 
  777. o Select the mode of operation for a popup keypad 
  778.  
  779. You can define a popup keypad to be either sticky or a non-sticky.  A sticky 
  780. popup keypad will remain displayed on your screen after an action is completed. 
  781. A non-sticky popup keypad will disappear after an action is complete. 
  782.  
  783.  
  784. ΓòÉΓòÉΓòÉ 4.8. Hotspots ΓòÉΓòÉΓòÉ
  785.  
  786. A hotspot is the area on a host screen that allows you to use your mouse to 
  787. execute a host function or host command without pressing a function key or 
  788. typing a command. 
  789.  
  790. The Hotspots Setup window allows you to select the function keys and host 
  791. commands that can be activated by using a mouse. 
  792.  
  793. You can access the Hotspots Setup window from the Settings menu on the Menu 
  794. Bar. 
  795.  
  796.  
  797. ΓòÉΓòÉΓòÉ 4.9. Numeric Lock ΓòÉΓòÉΓòÉ
  798.  
  799. The Numeric Lock window allows you to activate a numeric lock field in a host 
  800. application that is running on your 3270 emulator session. If you are working 
  801. in a host application containing protected fields that only accept certain 
  802. numbers and characters, this feature allows you to "turn off" the rest of the 
  803. keyboard while your cursor is in the protected field and minimize the chance 
  804. for errors. 
  805.  
  806. This feature is only available for 3270 emulator sessions. 
  807.  
  808.  
  809. ΓòÉΓòÉΓòÉ 4.10. Data Compression ΓòÉΓòÉΓòÉ
  810.  
  811. Data compression is the process of compressing repeated characters or repeated 
  812. data strings to shorten the length of records or blocks, thus reducing transfer 
  813. time for communications. 
  814.  
  815. Communications Manager supports SNA session level data compression with the Run 
  816. Length Encoding (RLE) and Limpel-Ziv 9-bit (LZ9) compression algorithms. 
  817.  
  818. With Communications Manager you can specify the use of data compression for 
  819. communications over 3270 and 5250 emulation sessions, APPC/APPN sessions, and 
  820. LUA sessions. To increase the speed of data transfer, EHLAPPI, APPC, and LUA 
  821. now support data compression for LU-LU sessions. 
  822.  
  823. Note:  3270 emulation supports only LZ9 for outbound data streams and RLE for 
  824. inbound data streams. 
  825.  
  826.  
  827. ΓòÉΓòÉΓòÉ 4.11. Double-Byte Character Set Support ΓòÉΓòÉΓòÉ
  828.  
  829. The Communications Manager OS/2 3270/5250 emulator now has both single-byte 
  830. character set (SBCS) and double-byte character set (DBCS) capability, making 
  831. Communications Manager fully-enabled for DBCS. 
  832.  
  833.  
  834. ΓòÉΓòÉΓòÉ 5. Installation and Configuration ΓòÉΓòÉΓòÉ
  835.  
  836. When you install Communications Manager, you indicate the directory where you 
  837. want the base files to be installed. The next step is to install a 
  838. configuration. 
  839.  
  840. Many customers require a program called LAN Adapter and Protocol Support (LAPS) 
  841. to make use of Communications Manager. You must install and configure LAPS 
  842. before you install Communications Manager in the following situations: 
  843.  
  844. o When you are going to upgrade a Communications Manager configuration that was 
  845.   established using OS/2 Extended Edition for use with local area network (LAN) 
  846.   Transport. 
  847.  
  848. o When you are going to use Communications Manager to establish connections on 
  849.   an integrated services digital network (ISDN). 
  850.  
  851. When you establish a configuration definition, you supply information about the 
  852. workstation and your network, and you make selections that indicate how you 
  853. want a feature or application to work on the workstation. 
  854.  
  855. Features and Applications That You Can Configure 
  856.  
  857. When you configure one or more of the features or applications for use with 
  858. Communications Manager, your workstation can perform the following functions: 
  859.  
  860. o 3270 emulation 
  861.  
  862. o 5250 emulation 
  863.  
  864. o ACDI APIs 
  865.  
  866. o ACDI redirection 
  867.  
  868. o APPC APIs 
  869.  
  870. o CPI Communications 
  871.  
  872. o LUA APIs 
  873.  
  874. o X.25 APIs 
  875.  
  876. o Gateway 
  877.  
  878. Communications Manager Configuration Methods 
  879.  
  880. For 3270 and 5250 emulation, Communications Manager offers two configuration 
  881. methods: 
  882.  
  883. o Default Configuration 
  884.  
  885. o Advanced Configuration 
  886.  
  887. When you configure features and applications other than emulation, 
  888. Communications Manager automatically uses the advanced configuration method. 
  889.  
  890. After your configuration is created, you can use Keylock to lock or unlock a 
  891. configuration. 
  892.  
  893.  
  894. ΓòÉΓòÉΓòÉ 5.1. Install a Configuration ΓòÉΓòÉΓòÉ
  895.  
  896. The setup process consists of creating or changing a configuration for your own 
  897. workstation or someone else's workstation. 
  898.  
  899. A configuration is a description of the devices, optional features, and 
  900. communications settings on your workstation. Communications Manager uses the 
  901. information stored in your configuration to establish and manage your network 
  902. communications. 
  903.  
  904. o You can use Communications Manager to create your configuration, and then 
  905.   install it. 
  906.  
  907. o You can install a configuration created for you by someone else. You must use 
  908.   this option if you are running the Communications Manager/2 Distributed 
  909.   Feature. 
  910.  
  911. o You can install a configuration created for your workstation with an earlier 
  912.   version of Communications Manager. 
  913.  
  914. If you are creating a new configuration, Communications Manager will guide you 
  915. through the setup process.  When you finish creating your configuration, you 
  916. have the option to install it or to save it to install at a later time. 
  917.  
  918. If you are installing an existing configuration, Communications Manager will 
  919. guide you through the installation process. Configurations created with an 
  920. earlier version of Communications Manager are automatically upgraded. 
  921.  
  922.  
  923. ΓòÉΓòÉΓòÉ 5.2. 3270 Emulation ΓòÉΓòÉΓòÉ
  924.  
  925. Your workstation functions as a 3270 terminal when communicating with an IBM 
  926. System/370* host computer. You can configure 3270 emulation for all workstation 
  927. connection types except asynchronous. 
  928.  
  929. * Trademark of IBM 
  930.  
  931.  
  932. ΓòÉΓòÉΓòÉ 5.3. 5250 Emulation ΓòÉΓòÉΓòÉ
  933.  
  934. Your workstation functions as a 5250 terminal when communicating with an IBM 
  935. Applications System/400* or an IBM System/36* host computer. You can configure 
  936. 5250 emulation for all workstation connection types except asynchronous and 
  937. DFT. 
  938.  
  939. *  Trademark of IBM 
  940.  
  941.  
  942. ΓòÉΓòÉΓòÉ 5.4. ACDI APIs ΓòÉΓòÉΓòÉ
  943.  
  944. Your workstation with an asynchronous connection uses custom applications that 
  945. interact with the functions of the asynchronous communications device interface 
  946. (ACDI) provided by Communications Manager.  For example, the Softerm** Custom 
  947. Plus ASCII Emulator uses the ACDI API to connect to various networks, such as 
  948. the IBM Information network. 
  949.  
  950. **  Trademark of Softronics, Inc. 
  951.  
  952.  
  953. ΓòÉΓòÉΓòÉ 5.5. ACDI Redirection ΓòÉΓòÉΓòÉ
  954.  
  955. Asynchronous communications device interface (ACDI) redirection is a 
  956. Communications Manager function that allows you to reassign the serial 
  957. communication ports on your workstation to asynchronous devices, such as 
  958. modems, at a Local Area Network Asynchronous Connection Server (LANACS) 
  959. gateway.  By reassigning ports, you can direct data to different destinations, 
  960. without changing your hardware configuration. 
  961.  
  962. Your Communications Manager workstation that is connected to a PC Network, 
  963. Ethernet (ETHERAND), token ring, or other LAN network, communicates with 
  964. asynchronous terminals and other devices by redirecting your serial port to a 
  965. LANACS server. You can configure ACDI redirection for all LAN workstation 
  966. connection types. 
  967.  
  968.  
  969. ΓòÉΓòÉΓòÉ 5.6. APPC APIs ΓòÉΓòÉΓòÉ
  970.  
  971. Your workstation uses the advanced program-to-program communications (APPC) 
  972. protocol to communicate with other network stations and to share programs with 
  973. those stations. You can configure APPC APIs for all workstation connection 
  974. types except asynchronous and coaxial (DFT). 
  975.  
  976.  
  977. ΓòÉΓòÉΓòÉ 5.7. CPI Communications ΓòÉΓòÉΓòÉ
  978.  
  979. Your workstation uses the common programming interface communications (CPI-C) 
  980. protocols and conventions to communicate with other network stations.  CPI-C is 
  981. the application program interface (API) provided with advanced peer-to-peer 
  982. networking (APPN).  You can configure CPI-C for all workstation connection 
  983. types except asynchronous and DFT. 
  984.  
  985.  
  986. ΓòÉΓòÉΓòÉ 5.8. LUA APIs ΓòÉΓòÉΓòÉ
  987.  
  988. Your workstation uses custom applications that interface with and use the 
  989. functions of logical unit (LU) programming. You can configure LUA APIs for all 
  990. workstation connection types except asynchronous and coaxial (DFT). 
  991.  
  992.  
  993. ΓòÉΓòÉΓòÉ 5.9. X.25 APIs ΓòÉΓòÉΓòÉ
  994.  
  995. Your workstation uses custom applications that use the functions of the X.25 
  996. network protocol. 
  997.  
  998.  
  999. ΓòÉΓòÉΓòÉ 5.10. Default Configuration ΓòÉΓòÉΓòÉ
  1000.  
  1001. This is the standard method that you use to configure 3270 or 5250 emulation on 
  1002. the following workstation connection types: 
  1003.  
  1004. o Ethernet (ETHERAND) network 
  1005.  
  1006. o PC Network 
  1007.  
  1008. o SDLC (synchronous data link control) 
  1009.  
  1010. o Token ring or other LAN types 
  1011.  
  1012. o Twinaxial. 
  1013.  
  1014. With default configuration, Communications Manager relies on a set of assumed 
  1015. defaults to set up the configuration definitions.  You have to supply only the 
  1016. information that is unique to your workstation and your network, such as the 
  1017. destination address and the local node name. 
  1018.  
  1019. You can set up your workstation quickly for emulation, without having to make a 
  1020. lot of decisions, by using the assumed defaults. 
  1021.  
  1022.  
  1023. ΓòÉΓòÉΓòÉ 5.11. Advanced Configuration ΓòÉΓòÉΓòÉ
  1024.  
  1025. When you use this method, you complete a set of profiles in which you select 
  1026. and supply information to make the emulation perform efficiently for your 
  1027. communication needs. 
  1028.  
  1029. When you want to tailor Communications Manager emulation operations to the 
  1030. special needs of your workstation or your network, advanced configuration is 
  1031. the best method. 
  1032.  
  1033. Note:  Communications Manager automatically uses the advanced configuration 
  1034. method if you select several features or applications in one configuration. 
  1035.  
  1036.  
  1037. ΓòÉΓòÉΓòÉ 5.12. Gateway ΓòÉΓòÉΓòÉ
  1038.  
  1039. This choice displays a list of the profiles you use to configure the 
  1040. workstation as a gateway. A gateway is a workstation that translates addresses 
  1041. between the network host computer and the workstations on your network. 
  1042.  
  1043.  
  1044. ΓòÉΓòÉΓòÉ 6. Application Programming Interfaces ΓòÉΓòÉΓòÉ
  1045.  
  1046. Communications Manager provides a number of application program interfaces 
  1047. (APIs) to address the communication needs for connections to both IBM and 
  1048. non-IBM computers. All of the APIs are accessible from both full-screen and 
  1049. windowed applications. 
  1050.  
  1051. o Emulator High-Level Language Application Programming Interface (EHLLAPI) 
  1052.  
  1053. o Server-Requester programming interface (SRPI) 
  1054.  
  1055. o Conventional LU application (LUA) 
  1056.  
  1057. o Advanced program-to-program communications (APPC) 
  1058.  
  1059. o SAA common programming interface (CPI) for communications 
  1060.  
  1061. o System management 
  1062.  
  1063. o Asynchronous communications device interface (ACDI) and ACDI Redirection APIs 
  1064.  
  1065. o X.25 
  1066.  
  1067. o Communications Manager Kernel 
  1068.  
  1069. o Common services 
  1070.  
  1071. o Service Point Application Router/Remote Operations Service (SPAR/ROPS) 
  1072.  
  1073. o ISDN Connection Manager Interface (CMI) 
  1074.  
  1075. o Generalized Call Control Interface (GCCI) 
  1076.  
  1077. o IBM Realtime Interface CoProcessor Device Driver Programming Interface 
  1078.  
  1079.  
  1080. ΓòÉΓòÉΓòÉ 6.1. Communications Manager Kernel ΓòÉΓòÉΓòÉ
  1081.  
  1082. The Communications Manager kernel is the main component of Communications 
  1083. Manager.  The kernel stops and starts other Communications Manager components 
  1084. and provides services that the components need.  The kernel provides 
  1085. Communications Manager status reporting services. 
  1086.  
  1087. The kernel API allows application programs to use kernel services.  The kernel 
  1088. API calls perform the following tasks: 
  1089.  
  1090. o Loading and unloading the kernel 
  1091.  
  1092. o Activating and deactivating service requests 
  1093.  
  1094. o Querying Communications Manager status 
  1095.  
  1096. o Retrieving an active directory name from the Communications Manager 
  1097.   environment. 
  1098.  
  1099.  
  1100. ΓòÉΓòÉΓòÉ <hidden> Asynchrous Communications Device Interface (ACDI) and ACDI Redir. APIs ΓòÉΓòÉΓòÉ
  1101.  
  1102. Communications Manager provides a programming interface for asynchronous 
  1103. communications and provides ACDI functions that do the following: 
  1104.  
  1105. o Provide device independence and support a variety of asynchronous 
  1106.   communications devices and connection types such as: 
  1107.  
  1108.    - Switched and non-switched lines 
  1109.  
  1110.    - Modems (auto-dial, auto-answer, manual dial, manual answer) 
  1111.  
  1112.    - Direct connections 
  1113.  
  1114. o Support asynchronous communications device command sets: 
  1115.  
  1116.    - Attention command set (an IBM-supplied and user-edited device command set 
  1117.      that supports Hayes** Smartmodem** and compatibles) 
  1118.  
  1119.    - CCITT V.25bis command set (an IBM-supplied and user-edited device command 
  1120.      set that supports V.25bis) 
  1121.  
  1122.    - No command set (a user-supplied device command set that supports circuits 
  1123.      that adhere to CCITT V.24) 
  1124.  
  1125. o Support traditional asynchronous communication protocols such as: 
  1126.  
  1127.    - Flow control 
  1128.  
  1129.    - Break processing 
  1130.  
  1131. o Support two dissimilar external devices attached through an A/B switch 
  1132.  
  1133. o Provide ports for resource management: 
  1134.  
  1135.    - Three asynchronous ports for computers with MicroChannel* buses (COM1, 
  1136.      COM2, COM3) 
  1137.  
  1138.    - Two asynchronous ports for computers with AT type buses (COM1, COM2) 
  1139.  
  1140. o Provide communications and system management (C & SM) support 
  1141.  
  1142. o Provide flexible input and output interfaces for data transfers 
  1143.  
  1144. o Manage application buffers for transmitted and received data 
  1145.  
  1146. o Provide asynchronous port sharing where auto-answer and auto-dial are 
  1147.   allocated to the same port 
  1148.  
  1149. o Assist country requirements for connecting computers to telephone networks. 
  1150.  
  1151. Communications Manager enables users to access a range of computers, including 
  1152. IBM and non-IBM host computer systems. In addition, several connections can be 
  1153. active concurrently, giving users rapid access to information from any point in 
  1154. a network. 
  1155.  
  1156. The Asynchronous Communications Device Interface (ACDI) can be redirected to an 
  1157. IBM Local Area Network Asynchronous Connection Server (LANACS) Version 2.0. 
  1158. LANACS is an IBM DOS product that provides asynchronous connection server 
  1159. capability to a LAN.  The server that runs the LANACS program provides 
  1160. asynchronous resource (serial ports, asynchronous connection equipment, and 
  1161. telephone lines) that can be shared by workstations on a LAN.  An Operating 
  1162. System/2* (OS/2*) workstation on the LAN can use serial ports on the 
  1163. asynchronous connection server as if the serial ports were located at the 
  1164. workstation. 
  1165.  
  1166. ACDI is the programming interface that provides support for those who want to 
  1167. use the serial ports for asynchronous communications in a multitasking 
  1168. environment.  ACDI interacts with the serial ports through the base operating 
  1169. system and ensures that interrupts are handled and data is buffered for 
  1170. applications as required. 
  1171.  
  1172. *  Trademark of IBM. 
  1173.  
  1174. ** Trademark of Hayes Microcomputer Products, Inc. 
  1175.  
  1176.  
  1177. ΓòÉΓòÉΓòÉ 6.2. Advanced Program-To-Program Communications (APPC) ΓòÉΓòÉΓòÉ
  1178.  
  1179. Communications Manager provides advanced peer-to-peer networking (APPN) end 
  1180. node and network node support for workstations, allowing them to communicate 
  1181. more flexibly with other systems in the network. 
  1182.  
  1183. Communications Manager provides advanced program-to-program communications 
  1184. (APPC) to support communications between distributed processing programs, 
  1185. called transaction programs (TPs).  APPN extends this capability to a 
  1186. networking environment.  The TPs can be located at any node in the network that 
  1187. provides APPC. 
  1188.  
  1189. Communications Manager improves APPC throughput in performance-critical local 
  1190. area network (LAN) environments. If you plan to install Communications Manager 
  1191. on a LAN, LAN adapter and protocol support (LAPS) is required. 
  1192.  
  1193. The level of LAPS shipped with Network Transport Services/2 (NTS/2) Version 1.0 
  1194. or LAN Server Version 3.0 is recommended; however, Communications Manager also 
  1195. supports the levels of LAPS available with LAN Server Version 2.0 and Extended 
  1196. Services for OS/2. Communications Manager supports the following protocols for 
  1197. APPC: 
  1198.  
  1199. o IBM Token-Ring Network 
  1200.  
  1201. o 3174 Peer Communications (LAN over coaxial support) 
  1202.  
  1203. o Token-Ring Bus Master 
  1204.  
  1205. o Synchronous Data Link Control (SDLC) 
  1206.  
  1207. o IBM PC Network* 
  1208.  
  1209. o Twinaxial 
  1210.  
  1211. o Ethernet (ETHERAND) 
  1212.  
  1213. o X.25 
  1214.  
  1215.  
  1216. ΓòÉΓòÉΓòÉ 6.3. System Management ΓòÉΓòÉΓòÉ
  1217.  
  1218. System management allows a system administrator to control and obtain status 
  1219. information about the SNA communication resources maintained by Communications 
  1220. Manager. It allows activation and deactivation of sessions and data link 
  1221. controls. 
  1222.  
  1223. System management provides verbs that perform display, subsystem management, 
  1224. configuration, management services, and node definition functions. The 
  1225. following list provides a brief description of the system management verbs: 
  1226.  
  1227. o Display verbs 
  1228.  
  1229.   Display verbs allow you to display general configuration information and 
  1230.   current operating values for SNA node. 
  1231.  
  1232. o Subsystem management verbs 
  1233.  
  1234.   The subsystem management verbs provide programs with a method for managing 
  1235.   sessions, links, and the APPC attach manager. 
  1236.  
  1237. o Configuration verbs 
  1238.  
  1239.   Configuration verbs allow authorized programs to configure resources such as 
  1240.   LUs and TPs. 
  1241.  
  1242. o Management services verbs 
  1243.  
  1244.   Management services verbs provide programs with a method of reporting 
  1245.   potential problems to management services focal points. 
  1246.  
  1247.  
  1248. ΓòÉΓòÉΓòÉ 6.4. ISDN Connection Manager Interface (CMI) ΓòÉΓòÉΓòÉ
  1249.  
  1250. Connection manager interface (CMI) is an interface that allows user 
  1251. applications to communicate with connection manager for the purpose of 
  1252. establishing connections (outgoing and incoming) across a switched network to 
  1253. remotely attached host computers and other workstations. 
  1254.  
  1255. Communications Manager provides a virtual media access control (MAC) driver for 
  1256. each supported protocol stack so that the application at the CMI can 
  1257. dynamically determine which protocol and logical adapter to use when the call 
  1258. instance (from the time you call, to the time you hang up) becomes active. 
  1259. This allows the actual data channels to be independent from protocols and 
  1260. logical adapter numbers. 
  1261.  
  1262. CMI provides support for the following protocols: 
  1263.  
  1264. o Integrated data link control (IDLC) 
  1265.  
  1266. o Synchronous data link control (SDLC) 
  1267.  
  1268. o X.25 
  1269.  
  1270. o LAN 
  1271.  
  1272.    - IEEE 802.2 
  1273.    - NetBIOS 
  1274.  
  1275. CMI provides automatic dialing and automatic answering capability for 
  1276. applications written to the X.25 interface and to the APPC interfaces (LUA, 
  1277. EHLLAPI, CPI Communications, and LU 6.2). 
  1278.  
  1279. Note that the 3270 and 5250 emulation features provided by Communications 
  1280. Manager are considered to be APPC applications.  SNA manages call control for 
  1281. IDLC and SDLC.  X.25 call control is managed by the X.25 feature. 
  1282. Communications Manager does not provide automatic dialing and automatic 
  1283. answering capability for the LAN interfaces (IEEE 802.2, NetBIOS, Named Pipes 
  1284. API, and Remote Procedure Call {RPC} API).  Applications written to these 
  1285. interfaces can be modified to use CMI if they require automatic dialing and 
  1286. automatic answering capability or can use the Communications Manager dial 
  1287. utilities to establish the physical connection by sidestream dialing. 
  1288.  
  1289. *  Trademark of IBM. 
  1290.  
  1291.  
  1292. ΓòÉΓòÉΓòÉ 6.5. Common Services ΓòÉΓòÉΓòÉ
  1293.  
  1294. The common services programming interface verbs are available to all 
  1295. application programs that use the Communications Manager APIs. 
  1296.  
  1297. The common services verbs perform the following tasks: 
  1298.  
  1299. o Enable and disable X.25 physical links 
  1300.  
  1301. o Provide American National Standard Code for Information Interchange (ASCII) 
  1302.   to extended binary-coded decimal interchange code (EBCDIC), EBCDIC to ASCII, 
  1303.   and user-defined conversions on data streams 
  1304.  
  1305. o Format data in the trace storage buffer and copy the data to a specified file 
  1306.  
  1307. o Provide dumping for user-selected components and provide specification of the 
  1308.   file to which dump data is written 
  1309.  
  1310. o Trace API verbs and data 
  1311.  
  1312. o Display configuration information and operating values for active SNA nodes 
  1313.  
  1314. o Produce the translation table for specified code pages so user programs can 
  1315.   perform table lookup on characters to convert character strings 
  1316.  
  1317. o Record messages in the FFST/2 message log 
  1318.  
  1319. o Send message and error logs to a user-supplied queue 
  1320.  
  1321. o Send network management services messages to a network management services 
  1322.   control point. 
  1323.  
  1324.  
  1325. ΓòÉΓòÉΓòÉ 6.6. Conventional LU Application (LUA) ΓòÉΓòÉΓòÉ
  1326.  
  1327. LUA shares a physical unit with the 3270 emulator, the gateway function, and 
  1328. the advanced program-to-program communications APPC API.  LUA extends the 
  1329. capabilities of Communications Manager by supplying two APIs: 
  1330.  
  1331. o Request-unit interface, a basic interface 
  1332.  
  1333. o Session-level interface, a higher-level interface. 
  1334.  
  1335. LUA provides secondary support only for BIND LU types 0, 1, 2, or 3. The type 
  1336. of SNA BIND profiles that are supported for LU-LU sessions depends on the 
  1337. access method used. 
  1338.  
  1339. The services that LUA provides to application programs include only those 
  1340. supporting data communications. LUA does not provide any device emulation 
  1341. facilities. However, LUA does provide a unique subset of presentation services 
  1342. (PS) functions. 
  1343.  
  1344. LUA communications-connectivity requirements include the following IBM host 
  1345. systems: 
  1346.  
  1347. o AS/400 
  1348. o S/36 
  1349. o S/38 
  1350. o S/370 
  1351.  
  1352. *  Trademark of IBM. 
  1353.  
  1354. LUA permits host attachment by the following: 
  1355.  
  1356. o Synchronous data link control (SDLC) 
  1357. o Token-ring network 
  1358. o X.25 
  1359. o IBM PC network protocol (using a gateway) 
  1360. o Ethernet (ETHERAND) network protocol (using a gateway) 
  1361. o 3174 Peer Communications 
  1362. o Token-ring bus master 
  1363. o Integrated services digital network (ISDN) 
  1364.  
  1365.    - SDLC 
  1366.    - X.25 
  1367.    - IDLC 
  1368.  
  1369.  
  1370. ΓòÉΓòÉΓòÉ 6.7. Emulator High-Level Language Application Programming Interface (EHLLAPI) ΓòÉΓòÉΓòÉ
  1371.  
  1372. The Emulator High-Level Language API (EHLLAPI) is an application programming 
  1373. interface that allows workstation programs to interact with a host using 3270 
  1374. or 5250 emulation. 
  1375.  
  1376. An EHLLAPI application program acts as a programmed operator (a program that 
  1377. performs and monitors activities in a workstation that are usually done by a 
  1378. human).  An EHLLAPI application program can perform some or all of the 
  1379. following functions: 
  1380.  
  1381. o Automate repetitive tasks 
  1382.  
  1383. o Mask complete applications from the user 
  1384.  
  1385. o Consolidate several complicated tasks into one simple task 
  1386.  
  1387. o Simplify existing host applications 
  1388.  
  1389. o Monitor response time and availability 
  1390.  
  1391. o Monitor events that are diverse in nature 
  1392.  
  1393. o Automate console operations 
  1394.  
  1395. In addition, EHLLAPI facilitates communication from workstation application 
  1396. programs to host application programs using the 3270 data stream structured 
  1397. fields.  This allows for the generation of programs such as the file transfer 
  1398. applications used to transfer files between host and workstation environments. 
  1399.  
  1400.  
  1401. ΓòÉΓòÉΓòÉ 6.8. Generalized Call Control Interface (GCCI) ΓòÉΓòÉΓòÉ
  1402.  
  1403. GCCI provides an interface to a port connection manager (PCM) so that the 
  1404. connection manager can manage the PCM resources and coordinate the 
  1405. establishment and disconnection of physical connections.  Each port on the 
  1406. network has its own PCM that is responsible for controlling access to the 
  1407. switched network. 
  1408.  
  1409.  
  1410. ΓòÉΓòÉΓòÉ 6.9. IBM Realtime Interface CoProcessor Device Driver Programming Interface ΓòÉΓòÉΓòÉ
  1411.  
  1412. The IBM Realtime Interface Co-Processor device driver is used by the base 
  1413. operating system to support the Realtime Interface Co-Processor family of 
  1414. communication adapters, including the following adapters: 
  1415.  
  1416. o Realtime Interface Co-Processor 2 Port 
  1417.  
  1418. o Multiport 
  1419.  
  1420. o Multiport Model 2 
  1421.  
  1422. o Multiport/2 
  1423.  
  1424. o PortMaster 
  1425.  
  1426. o X.25 
  1427.  
  1428. The device driver programming interface is available with Communications 
  1429. Manager for users who want to provide their own programming support for the 
  1430. co-processor adapter.  The main functions of the device driver are to: 
  1431.  
  1432. o Handle interrupts from the co-processor adapter 
  1433.  
  1434. o Determine which task on which co-processor adapter interrupted the system 
  1435.   unit, and signal the appropriate system unit processes 
  1436.  
  1437. o Read the parameter file and configure the co-processor adapter accordingly 
  1438.  
  1439. o Provide a programming interface to the co-processor adapter through the 
  1440.   generic input/output control (IOCtl) interface or through a set of dynamic 
  1441.   link libraries (DLL) 
  1442.  
  1443.  
  1444. ΓòÉΓòÉΓòÉ 6.10. SAA Common Programming Interface (CPI) for Communications ΓòÉΓòÉΓòÉ
  1445.  
  1446. The Systems Application Architecture (SAA) Common Programming Interface for 
  1447. Communications (CPI Communications) provides an alternative method of 
  1448. program-to-program communications that uses SNA LU 6.2 facilities. 
  1449.  
  1450. SAA describes a set of software interfaces, conventions, and protocols that 
  1451. provide a framework for designing and developing portable applications. 
  1452. Applications that follow SAA guidelines are easily integrated and will run on 
  1453. any hardware and software platform that provides an SAA environment. 
  1454.  
  1455. Both advanced program-to-program communications (APPC) and CPI Communications 
  1456. support transaction programs (TPs) that use Communications Manager APPC 
  1457. support. CPI Communications TPs, however, call SAA CPI Communications functions 
  1458. rather than issue APPC verbs. 
  1459.  
  1460. The CPI Communications functions and APPC verbs provide similar services. 
  1461. However, CPI Communications provides an API that is portable across multiple 
  1462. SAA platforms. 
  1463.  
  1464. CPI Communications provides calls for applications that require 
  1465. program-to-program communication. It makes use of SNA LU 6.2 facilities that 
  1466. include: 
  1467.  
  1468. o Starting a partner TP on a remote system 
  1469.  
  1470. o Sending or receiving data with a partner TP 
  1471.  
  1472. o Notifying a partner TP that an error has been detected 
  1473.  
  1474. o Synchronizing partner TPs 
  1475.  
  1476.  
  1477. ΓòÉΓòÉΓòÉ 6.11. Server-Requester Programming Interface (SRPI) ΓòÉΓòÉΓòÉ
  1478.  
  1479. The SRPI is a high-level API that allows programmers to write SRPI requester 
  1480. programs that request servers to perform tasks.  The SRPI API also supports 
  1481. ECF. 
  1482.  
  1483. ECF is a set of programs for interconnecting IBM workstations and IBM 
  1484. System/370 host computers operating in the MVS/XA or VM/SP environment. 
  1485.  
  1486. IBM ECF simplifies the way different systems use services over a connection. 
  1487. ECF provides a single interface that allows application programmers to write 
  1488. workstation and host applications that run on a variety of communication 
  1489. connections. 
  1490.  
  1491. SRPI has the following characteristics: 
  1492.  
  1493. o An interface for application programs in a workstation to request services, 
  1494.   data, or both from a host.  The requesting program is referred to as the SRPI 
  1495.   requester. 
  1496.  
  1497. o An interface for programs in a host to reply to requests for services, data, 
  1498.   or both from workstations.  The program that services the request is referred 
  1499.   to as the server. 
  1500.  
  1501. The SRPI requester and server programs operate in pairs, with the SRPI 
  1502. requester in the workstation and the server in the host computer. 
  1503.  
  1504. The SRPI router is a Communications Manager facility that uses information 
  1505. defined in the SRPI server profiles to route send requests to server programs 
  1506. using the appropriate 3270 sessions. 
  1507.  
  1508.  
  1509. ΓòÉΓòÉΓòÉ 6.12. Service Point Application Router/Remote Operations Service (SPAR/ROPS) ΓòÉΓòÉΓòÉ
  1510.  
  1511. A network management API allows you to initiate the processing of host NetView 
  1512. program commands from OS/2 programs. 
  1513.  
  1514. Communications Manager lets you initiate workstation commands from the host 
  1515. NetView program. The standard output of the commands is returned to the host 
  1516. NetView program. 
  1517.  
  1518. Two Communications Manager components provide this network management 
  1519. capability:  Service Point Application Router (SPA Router) and Remote 
  1520. Operations Service (ROP Service). SPA Router and ROP Service provide the 
  1521. following features: 
  1522.  
  1523. o Support for multiple LANs and multiple physical units (PUs) 
  1524.  
  1525. o Administration of wide area networks 
  1526.  
  1527. o System administration functions 
  1528.  
  1529. o Administration of different domains 
  1530.  
  1531. SPA Router is an OS/2 program that receives commands from the host NetView 
  1532. program and sends them to the specified application programs.  SPA Router can 
  1533. receive commands for multiple OS/2 applications concurrently. 
  1534.  
  1535. ROP Service processes, on the workstation, commands that the host NetView 
  1536. program sends through SPA Router.  ROP Services can process any OS/2 command 
  1537. that has a command line interface and that does not require operator input. 
  1538.  
  1539.  
  1540. ΓòÉΓòÉΓòÉ 6.13. X.25 ΓòÉΓòÉΓòÉ
  1541.  
  1542. The X.25 API enables non-SNA application programs to communicate with 
  1543. workstations, IBM hosts, and non-IBM hosts, using X.25 networks. 
  1544.  
  1545. X.25 packet switching data networks (PSDNs) are wide area networks (WANs) that 
  1546. usually connect workstations and computers over large geographical distances. 
  1547. An X.25 network subscriber can make calls to other subscribers and can have 
  1548. many calls in operation at the same time. Most public X.25 networks are 
  1549. interconnected, enabling world-wide international calling. Many corporations 
  1550. have their own private networks, while some are connected to public networks. 
  1551.  
  1552. Data is transmitted over an X.25 network in discrete, independent units called 
  1553. packets. Packets are sent over virtual circuits set up through the X.25 
  1554. network. Because virtual circuits are duplex, packets can be flowing in both 
  1555. directions at the same time. 
  1556.  
  1557. The placing of data in packets and the use of virtual circuits instead of real 
  1558. circuits enables a PSDN to dynamically and optimally manage its real resources. 
  1559. Packets from different virtual circuits can be multiplexed on the same 
  1560. communication line by the PSDN. However, to a network subscriber, a virtual 
  1561. circuit appears to be a dedicated line. A workstation may only need one 
  1562. physical link to communicate with many other workstations and computers because 
  1563. the link can carry many virtual circuits concurrently. 
  1564.  
  1565. This optimal use of resources can result in communications equipment savings 
  1566. which can, in turn, result in cheaper communications costs for the X.25 network 
  1567. subscriber. 
  1568.  
  1569.  
  1570. ΓòÉΓòÉΓòÉ 7. Problem Diagnosis ΓòÉΓòÉΓòÉ
  1571.  
  1572. Communications Manager provides the following information to assist in problem 
  1573. diagnosis: 
  1574.  
  1575. o Messages 
  1576. o Errors 
  1577. o Alerts 
  1578. o Traces 
  1579. o Dumps 
  1580.  
  1581. Communications Manager provides the following problem diagnosis facilities to 
  1582. display and interpret problem diagnosis information: 
  1583.  
  1584. o FFST/2 
  1585. o Problem Determination Aids 
  1586. o Common Services Application Programming Interface 
  1587.  
  1588.  
  1589. ΓòÉΓòÉΓòÉ 7.1. Messages ΓòÉΓòÉΓòÉ
  1590.  
  1591. Messages are displayed during Communications Manager sessions.  The appearance 
  1592. of a message does not always mean an error occurred.  For example, a message 
  1593. may tell you that an operation is in progress or complete. 
  1594.  
  1595. Online help is available for Communications Manager messages. In addition, 
  1596. detailed descriptions of all Communications Manager messages, their causes, and 
  1597. actions you should take are available in the Message Reference.  You can access 
  1598. this reference online by selecting it from the Communications Manager/2 folder. 
  1599.  
  1600. Communications Manager message types and the actions you should take to respond 
  1601. to them are: 
  1602.  
  1603. o Information message 
  1604. o Warning message 
  1605. o Action message 
  1606. o File transfer message (TRANS prefix) 
  1607. o OIA message 
  1608. o Device driver message 
  1609.  
  1610. Messages and message helps are logged and displayed in the following ways: 
  1611.  
  1612. o Pop-up Window 
  1613. o Message Console 
  1614. o Message Log Formatter 
  1615.  
  1616.  
  1617. ΓòÉΓòÉΓòÉ <hidden> Information Message ΓòÉΓòÉΓòÉ
  1618.  
  1619. An information message appears if a situation occurs and there is no action you 
  1620. must take in response to the situation. 
  1621.  
  1622.  
  1623. ΓòÉΓòÉΓòÉ <hidden> Warning Message ΓòÉΓòÉΓòÉ
  1624.  
  1625. A warning message appears if a situation exists that you should be made aware 
  1626. of. Some warning messages include corrective actions you can take if you decide 
  1627. to modify the situation. 
  1628.  
  1629.  
  1630. ΓòÉΓòÉΓòÉ <hidden> Action Message ΓòÉΓòÉΓòÉ
  1631.  
  1632. An action message appears if a situation arises in which you must take some 
  1633. explicit action to correct the situation, or choose an alternative action. 
  1634. Correct the situation by taking the action provided with the message.  If 
  1635. instructions are not provided, select Help to view an explanation of the 
  1636. situation and the corrective action you can take for it. 
  1637.  
  1638.  
  1639. ΓòÉΓòÉΓòÉ <hidden> File Transfer Message (TRANS prefix) ΓòÉΓòÉΓòÉ
  1640.  
  1641. A file transfer message appears during file transfer with a 3270 host to report 
  1642. the current status of the transfer. 
  1643.  
  1644.  
  1645. ΓòÉΓòÉΓòÉ <hidden> OIA Message ΓòÉΓòÉΓòÉ
  1646.  
  1647. OIA messages appear on the operator information area (OIA) line at the bottom 
  1648. of the 3270 or 5250 session window. This area provides information about 
  1649. sessions and presentation space printing, including status and error messages. 
  1650. Host application programs also use this line to display messages that explain 
  1651. keystroke errors (although some programs may use a different line). 
  1652.  
  1653. You can use the online help information provided during a session to determine 
  1654. the causes and actions for those messages: 
  1655.  
  1656. o If your host computer is an AS/400, the host automatically displays help 
  1657.   information when you make a keystroke error. 
  1658.  
  1659. o If your host computer is an IBM System/36* (S/36*), press the Help key to 
  1660.   display help information about an error code. 
  1661.  
  1662. o Select OIA message from the menu bar for additional OIA message information. 
  1663.  
  1664. Press the Error Reset key to return to the OIA display for 5250 sessions. 
  1665.  
  1666. *  Trademark of IBM. 
  1667.  
  1668.  
  1669. ΓòÉΓòÉΓòÉ <hidden> Device Driver Message ΓòÉΓòÉΓòÉ
  1670.  
  1671. Device driver messages appear during startup of the workstation. 
  1672.  
  1673.  
  1674. ΓòÉΓòÉΓòÉ 7.2. Errors ΓòÉΓòÉΓòÉ
  1675.  
  1676. Errors are unexpected results that occur during a Communications Manager 
  1677. operation which require more detailed information than can be provided in a 
  1678. message.  Errors are logged in the system error log. 
  1679.  
  1680.  
  1681. ΓòÉΓòÉΓòÉ 7.3. Alerts ΓòÉΓòÉΓòÉ
  1682.  
  1683. Alerts are information units sent to a management services focal point in a 
  1684. network to identify problems or impending problems. Alerts are logged in 
  1685. EPWALERT.DMP, which you can view by using the FFST/2 dump formatter. 
  1686.  
  1687. See the Problem Determination Guide for more information about alerts. 
  1688.  
  1689.  
  1690. ΓòÉΓòÉΓòÉ 7.4. Traces ΓòÉΓòÉΓòÉ
  1691.  
  1692. Traces are records of data that provide a history of events that occurred 
  1693. during communications.  Select Problem determination aids in the Communications 
  1694. Manager/2 folder to obtain trace information. 
  1695.  
  1696. See the Problem Determination Guide for more information about traces. 
  1697.  
  1698.  
  1699. ΓòÉΓòÉΓòÉ 7.5. Dumps ΓòÉΓòÉΓòÉ
  1700.  
  1701. Dumps are copies of data stored in a portion of memory being used by 
  1702. Communications Manager components. Select Problem determination aids in the 
  1703. Communications Manager/2 folder to obtain dump information. 
  1704.  
  1705. See the Problem Determination Guide for more information about dumps. 
  1706.  
  1707.  
  1708. ΓòÉΓòÉΓòÉ <hidden> Pop-Up Window ΓòÉΓòÉΓòÉ
  1709.  
  1710. Usually the first indication of a problem is when a message appears in a pop-up 
  1711. window to let you know that a situation has occurred which may require your 
  1712. attention.  In most cases, help is available from this window. 
  1713.  
  1714.  
  1715. ΓòÉΓòÉΓòÉ <hidden> Message Console ΓòÉΓòÉΓòÉ
  1716.  
  1717. The message console is a window that you can activate to view messages as they 
  1718. are logged.  This service provides a similar function to the message log; 
  1719. however, no help is provided for the messages and the window's contents are 
  1720. erased when closed. 
  1721.  
  1722. For Communications Manager, use the message log formatter as the focal point 
  1723. for problem diagnosis and use the message console for configuring FFST/2. 
  1724.  
  1725.  
  1726. ΓòÉΓòÉΓòÉ <hidden> Message Log Formatter ΓòÉΓòÉΓòÉ
  1727.  
  1728. The message log formatter provides access to the Communications Manager 
  1729. messages that are stored in the default FFST/2 message log (OS2MLOG.DAT) and in 
  1730. other message logs defined by Communications Manager. 
  1731.  
  1732. When you receive a message, view the message in the message log formatter. 
  1733. Read the entire message and the message help and perform the actions indicated. 
  1734. If the message instructs you to look in the system error log or the FFST/2 dump 
  1735. formatter, note the time of the message and the problem ID to help you access 
  1736. the appropriate entries in the system error log and the dump formatter. 
  1737.  
  1738.  
  1739. ΓòÉΓòÉΓòÉ <hidden> FFST/2 ΓòÉΓòÉΓòÉ
  1740.  
  1741. First Failure Support Technology/2* (FFST/2*) is a software problem diagnosis 
  1742. tool for OS/2 system software and applications.  It is designed to facilitate 
  1743. the capture of problem diagnosis information when a problem occurs. 
  1744.  
  1745. The following FFST/2 facilities are in the FFST/2 folder: 
  1746.  
  1747. o Start FFST/2 
  1748. o Stop FFST/2 
  1749. o Message Console 
  1750. o System Error Log 
  1751. o Dump Formatter 
  1752. o Message Log Formatter 
  1753.  
  1754. Unless you are an advanced user, your primary use of FFST/2 will be the system 
  1755. error log and the message log formatter choices. Refer to the Problem 
  1756. Determination Guide for a complete description of the tasks you can perform 
  1757. with FFST/2. 
  1758.  
  1759. *  Trademark of IBM. 
  1760.  
  1761.  
  1762. ΓòÉΓòÉΓòÉ <hidden> Start FFST/2 ΓòÉΓòÉΓòÉ
  1763.  
  1764. Select the Start FFST/2 icon in the FFST/2 folder to start the FFST/2 process. 
  1765. Add RUN=EPW to CONFIG.SYS file to start this process at system startup. 
  1766.  
  1767.  
  1768. ΓòÉΓòÉΓòÉ <hidden> Stop FFST/2 ΓòÉΓòÉΓòÉ
  1769.  
  1770. Select the Stop FFST/2 icon in the FFST/2 folder to stop the FFST/2 process. 
  1771.  
  1772. Note:  This is not recommended because problem diagnosis information may not be 
  1773. processed.  However, in many cases, Communications Manager will restart FFST/2 
  1774. if a problem occurs. 
  1775.  
  1776.  
  1777. ΓòÉΓòÉΓòÉ <hidden> System Error Log ΓòÉΓòÉΓòÉ
  1778.  
  1779. The system error log is an OS/2 facility that contains information about the 
  1780. problem and the environment in which the problem occurred. Messages logged to 
  1781. the message log formatter often describe how to extract information from the 
  1782. system error log; therefore, always check the message log formatter before 
  1783. checking the system error log. 
  1784.  
  1785. Note:  If you are using OS/2 Version 2.0 or higher, you must install the OS/2 
  1786. Serviceability and Diagnostic Aids to enable Communications Manager system 
  1787. error logging. 
  1788.  
  1789.  
  1790. ΓòÉΓòÉΓòÉ <hidden> Dump Formatter ΓòÉΓòÉΓòÉ
  1791.  
  1792. The dump formatter is a customized dump facility that can contain detailed 
  1793. information about a failure and the environment in which it occurred. 
  1794. Communications Manager uses this facility to supply and format detailed 
  1795. information about alerts. 
  1796.  
  1797.  
  1798. ΓòÉΓòÉΓòÉ <hidden> Problem Determination Aids ΓòÉΓòÉΓòÉ
  1799.  
  1800. Problem Determination Aids is a problem diagnosis facility in Communications 
  1801. Manager that provides trace and dump services. 
  1802.  
  1803. Use trace services to trace application programming interfaces (APIs) and data 
  1804. transmitted on communication links. 
  1805.  
  1806. Use dump services to make copies (or a dump) of the data stored in portions of 
  1807. memory used by Communications Manager for analysis by IBM. 
  1808.  
  1809. Problem Determination Aids is installed as additional function. 
  1810.  
  1811.  
  1812. ΓòÉΓòÉΓòÉ 8. Hints and Tips ΓòÉΓòÉΓòÉ
  1813.  
  1814. You can use these hints and tips when using Communications Manager. Refer also 
  1815. to the README file for more hints and tips. 
  1816.  
  1817. Select one of the following for more information: 
  1818.  
  1819. o Installation 
  1820.  
  1821. o CMSETUP Options 
  1822.  
  1823. o Virtual device driver support 
  1824.  
  1825. o Sample Programs 
  1826.  
  1827. o Configuration 
  1828.  
  1829. o Configuration, Installation, and Distribution (CID) 
  1830.  
  1831. o Gateway and multiple PU support 
  1832.  
  1833. o Command Enhancements 
  1834.  
  1835. o ACDI Redirection Upgrade Restriction 
  1836.  
  1837.  
  1838. ΓòÉΓòÉΓòÉ 8.1. Installation ΓòÉΓòÉΓòÉ
  1839.  
  1840. For additional installation information, read the README file on the 
  1841. installation diskettes (or in the redirected installation directory).  This 
  1842. file contains any last-minute documentation updates. 
  1843.  
  1844. For more hints and tips about installation, select one of the following: 
  1845.  
  1846. o LAPS installation 
  1847.  
  1848. o Upgrade from a previous version 
  1849.  
  1850.  
  1851. ΓòÉΓòÉΓòÉ 8.1.1. LAPS Installation ΓòÉΓòÉΓòÉ
  1852.  
  1853. LAN Adapter and Protocol Support (LAPS) is a component that allows you to 
  1854. configure and make changes to your network adapters and protocols for the 
  1855. purpose of enhancing network performance. 
  1856.  
  1857. Communications Manager installation verifies that LAPS is installed, but it 
  1858. does not verify that LAPS is properly configured. 
  1859.  
  1860. If one of the following products has been installed on your workstation, an 
  1861. acceptable version of LAPS may already be available; however, only NTS/2 
  1862. provides the level of LAPS support necessary for using ISDN. 
  1863.  
  1864. o IBM Extended Services for OS/2 
  1865.  
  1866. o IBM TCP/IP for OS/2 
  1867.  
  1868. o IBM LAN Server (or LAN Requester) 
  1869.  
  1870. o IBM Network Transport Services/2 
  1871.  
  1872.  
  1873. ΓòÉΓòÉΓòÉ 8.1.2. Upgrade from a Previous Version ΓòÉΓòÉΓòÉ
  1874.  
  1875. If you are migrating from a previous version of Communications Manager, and you 
  1876. are planning to install on a different drive: 
  1877.  
  1878. o Remove the previous version using the REINST command. If this is not done, 
  1879.   the files from the previous version remain on the drive although they are not 
  1880.   usable. 
  1881.  
  1882. o Remove any Communications Manager-dependent products such as GDDM-OS/2 Link. 
  1883.   The HGREMOVE command erases the GDDM-OS/2 Link files. 
  1884.  
  1885. o Remove any references to the former product from the LIBPATH, PATH and DPATH 
  1886.   statements in your CONFIG.SYS file. 
  1887.  
  1888. o Back up data files, such as the configuration files. They can be migrated and 
  1889.   used by this release of Communications Manager/2. 
  1890.  
  1891. Note:  It is advisable to back up your CONFIG.SYS before modifying it. 
  1892.  
  1893.  
  1894. ΓòÉΓòÉΓòÉ 8.2. CMSETUP Options ΓòÉΓòÉΓòÉ
  1895.  
  1896. CMSETUP and CMREDIR provide the following options from the menu bar. Select any 
  1897. option for additional information. 
  1898.  
  1899. o Install additional functions... 
  1900.  
  1901. o Remove additional features... 
  1902.  
  1903. o Reinstall... 
  1904.  
  1905. o Remove Communications Manager... 
  1906.  
  1907. o Remove communications features... 
  1908.  
  1909. o View system information... 
  1910.  
  1911. o View audit trail... 
  1912.  
  1913. o Recreate folders... 
  1914.  
  1915.  
  1916. ΓòÉΓòÉΓòÉ 8.2.1. Install Additional Functions ΓòÉΓòÉΓòÉ
  1917.  
  1918. Install additional functions... allows you to add a variety of functions and 
  1919. online documents. 
  1920.  
  1921. As you select the items you want to install, the required disk space and the 
  1922. space you have available display in the Install Additional Functions window. 
  1923.  
  1924. For information on these functions, refer to the Workstation Installation and 
  1925. Configuration Guide 
  1926.  
  1927.  
  1928. ΓòÉΓòÉΓòÉ 8.2.2. Remove additional functions ΓòÉΓòÉΓòÉ
  1929.  
  1930. Remove additional features... allows you to remove any of the functions or 
  1931. online documents that were previously installed.  You can select the functions 
  1932. or online documents to remove from a displayed list. 
  1933.  
  1934.  
  1935. ΓòÉΓòÉΓòÉ 8.2.3. Reinstall ΓòÉΓòÉΓòÉ
  1936.  
  1937. Reinstall reinstalls the base Communications Manager/2 product and any 
  1938. components necessary for the selected functions.  This option is used when 
  1939. Communications Manager/2 files have been erased or damaged. 
  1940.  
  1941.  
  1942. ΓòÉΓòÉΓòÉ 8.2.4. Remove Communications Manager/2 ΓòÉΓòÉΓòÉ
  1943.  
  1944. Remove Communications Manager/2... removes the product from your workstation. 
  1945. First failure support technology (FFST) and user profile management (UPM) are 
  1946. not removed.  The \CMLIB directory remains on the target drive with any other 
  1947. files that you have added, such as configuration files for the Graphical Data 
  1948. Display Manager-OS2 (GDDM-OS2) Link files. 
  1949.  
  1950. As a final step in the removal process, the \CMLIB\CM.LOG which contains the 
  1951. audit trail is reset to indicate that the product has been removed.  All prior 
  1952. installation history is erased. 
  1953.  
  1954.  
  1955. ΓòÉΓòÉΓòÉ 8.2.5. Remove Communications Features ΓòÉΓòÉΓòÉ
  1956.  
  1957. Remove communications features... removes all files associated with 
  1958. configuration files other than your default configuration.  Features are major 
  1959. components of Communications Manage/2 such as 3270 emulation, 5250 emulation, 
  1960. or the gateway. 
  1961.  
  1962. Choosing this options also allows you to remove any statements in CONFIG.SYS 
  1963. that are specific to removed configurations.  The actual configuration files 
  1964. remain untouched and can be reloaded at any time by selecting Installation in 
  1965. the Communications Manager Setup window. 
  1966.  
  1967. Warning: All of the new network graphic images are held in the \CMLIB\*.MET 
  1968. files.  In general, it is not advisable to remove Communications Manager 
  1969. configurations by doing an ERASE\CMLIB\cfgname.* as this could destroy files 
  1970. not related to your configuration.  This is particularly true now as many of 
  1971. the MET files have relatively common names such as 5250X25.MET.  If you happen 
  1972. to have a 5250X25.CFG and you erase it with the above command, then you would 
  1973. lose the 5250 over X.25 image also.  It is safer to use a file utility, such as 
  1974. the OS/2 File Manager, to identify each file to be erased. 
  1975.  
  1976.  
  1977. ΓòÉΓòÉΓòÉ 8.2.6. View System Information ΓòÉΓòÉΓòÉ
  1978.  
  1979. View system information... displays the: 
  1980.  
  1981. o Communications Manager version number 
  1982. o Workstation type 
  1983. o Default configuration 
  1984. o Configuration path 
  1985.  
  1986.  
  1987. ΓòÉΓòÉΓòÉ 8.2.7. View Audit Trail ΓòÉΓòÉΓòÉ
  1988.  
  1989. View audit trail... displays a record of every Communications Manager feature 
  1990. that is installed.  The audit trail is a specific Communications Manager file 
  1991. called \CMLIB\CM.LOG.  Error messages are also logged here during the initial 
  1992. installation steps before FFST/2 is available. 
  1993.  
  1994.  
  1995. ΓòÉΓòÉΓòÉ 8.2.8. Recreate folders ΓòÉΓòÉΓòÉ
  1996.  
  1997. Recreate folders... allows you to recreate a folder and objects in the folder. 
  1998. This is useful if you have accidentally deleted the objects. 
  1999.  
  2000.  
  2001. ΓòÉΓòÉΓòÉ 8.3. Virtual Device Driver Support ΓòÉΓòÉΓòÉ
  2002.  
  2003. When you use OS/2 Version 2.0 or later and Communications Manager/2, support is 
  2004. available for virtual device drivers.  This allows a DOS program to 
  2005. simultaneously use a device driver with an OS/2 program.  This support is 
  2006. currently available for the following interfaces: 
  2007.  
  2008. o Emulator high level language application programming interface (EHLLAPI) 
  2009.  
  2010. o 802.2 
  2011.  
  2012. o Local area network basic input/output system (NetBIOS) 
  2013.  
  2014. The support for the virtual 802.2 and NetBIOS interfaces is supplied by IBM 
  2015. network transport services/2 (NTS/2). 
  2016.  
  2017. Communications Manager provides the virtual EHLLAPI interface. Installation 
  2018. consists of typing VHAPINST from a windowed or fullscreen OS/2 session. 
  2019.  
  2020.  
  2021. ΓòÉΓòÉΓòÉ 8.4. Sample Programs ΓòÉΓòÉΓòÉ
  2022.  
  2023. The sample programs are provided on the API Support Diskette which is 
  2024. distributed with the Application Programming Guide. This publication is ordered 
  2025. separately. 
  2026.  
  2027. The sample programs are provided as a tool to aid in the development of 
  2028. programs that use Communications Manager application programming interfaces 
  2029. (APIs). 
  2030.  
  2031. The sample programs are installed by decompressing the ZIP files. Refer to the 
  2032. README.DOC file on the API Support Diskette for additional information. 
  2033.  
  2034.  
  2035. ΓòÉΓòÉΓòÉ 8.5. Configuration ΓòÉΓòÉΓòÉ
  2036.  
  2037. There are three methods to create or change a Communications Manager 
  2038. configuration.  For more information on any of these methods, select one of the 
  2039. items below. 
  2040.  
  2041. o Using interactive configuration (CMSETUP) 
  2042. o Using CID Response Files 
  2043. o Editing the .NDF file 
  2044.  
  2045. Note:  IBM Extended Services for OS/2 Programmable Configuration has been 
  2046. replaced by CID. 
  2047.  
  2048. Select an item below for additional configuration information. 
  2049.  
  2050. o Using the configuration program 
  2051. o Verifying configuration files 
  2052. o Copying configuration profiles 
  2053. o Other configuration concerns 
  2054.  
  2055.  
  2056. ΓòÉΓòÉΓòÉ 8.5.1. Gateway and Multiple PU Support ΓòÉΓòÉΓòÉ
  2057.  
  2058. Some benefits of a gateway are: 
  2059.  
  2060. o Reducing the host PU definitions 
  2061.  
  2062. o Eliminating communications links 
  2063.  
  2064. o Reducing the host system load due to less PU polling. 
  2065.  
  2066. o Allowing for protocol conversion between the host and the dependent 
  2067.   workstations 
  2068.  
  2069. Communications Manager/2 has made a number of changes in the gateway support: 
  2070.  
  2071. o Gateway configuration is easier and less error-prone due to the OS/2 
  2072.   Presentation Manager configuration interface (CMSETUP). 
  2073.  
  2074. o Downstream workstations can now be defined using models. 
  2075.  
  2076. o Several host systems can now be defined with multiple PU support. 
  2077.  
  2078. o The SNA gateway supports up to 254 concurrently active workstations (logical 
  2079.   units) per host on the LAN.  Communications Manager/2 supports up to five 
  2080.   concurrent physical host connections. 
  2081.  
  2082. o Host and workstation definitions can now be done directly in the .NDF file. 
  2083.  
  2084. o Host and workstation definitions can be changed dynamically. 
  2085.  
  2086. For information on gateway restrictions, refer to the Restrictions chapter of 
  2087. this Overview, and the README file. 
  2088.  
  2089. Select one of the following items for additional gateway information. 
  2090.  
  2091. o The CMGWSESS Utility 
  2092. o Suggestions 
  2093.  
  2094.  
  2095. ΓòÉΓòÉΓòÉ 8.5.2. The CMGWSESS Utility ΓòÉΓòÉΓòÉ
  2096.  
  2097. The CMGWSESS utility is available for downstream dependent workstations on a 
  2098. gateway.  CMGWSESS is executed on the dependent workstation and it displays 
  2099. information concerning all sessions with the gateway node. 
  2100.  
  2101. All of the information returned by CMGWSESS is available on the gateway 
  2102. machine.  It could be useful for the user on the dependent workstation, 
  2103. however, if the gateway machine is not physically accessible.  It allows the 
  2104. user to get information concerning the LUs and host system which might be 
  2105. helpful to identify network problems. 
  2106.  
  2107. CMGWSESS relies upon the ability to initiate an LU 6.2 conversation with the 
  2108. (Remote Display Server) program on the gateway machine. The LU 6.2 sessions in 
  2109. fact show up in the data produced by CMGWSESS.  This implies that the gateway 
  2110. machine must be appropriately customized for accepting an APPC conversation. 
  2111.  
  2112.  
  2113. ΓòÉΓòÉΓòÉ 8.5.3. Suggestions ΓòÉΓòÉΓòÉ
  2114.  
  2115. Gateway host LU pool selection 
  2116.  
  2117. You assign a name when you create a new pool.  It is advisable to include an 
  2118. indication of the host name within the eight character pool identification. 
  2119. This is recommended because of the gateway session information displayed within 
  2120. the subsystem management application. 
  2121.  
  2122.  
  2123. ΓòÉΓòÉΓòÉ 8.5.4. Using Interactive Configuration (CMSETUP) ΓòÉΓòÉΓòÉ
  2124.  
  2125. You can create or change a Communications Manager configuration using 
  2126. interactive configuration, which is the CMSETUP command.  Information is 
  2127. entered using a series of Presentation Manager windows.  When you complete a 
  2128. configuration, an automatic verification step examines the configuration files 
  2129. you created and if no conflicts exist, creates the required configuration 
  2130. files.  If there are conflicts, errors are saved in a log file.  You can then 
  2131. choose to correct the errors in the configuration. 
  2132.  
  2133. Most workstation configuration can be created using CMSETUP; however, a few 
  2134. verbs and some parameters of other verbs are not supported by CMSETUP.  Refer 
  2135. to Network Administration and Subsystem Management Guide for a list of these 
  2136. verbs and parameters. 
  2137.  
  2138.  
  2139. ΓòÉΓòÉΓòÉ 8.5.5. Using CID Response Files ΓòÉΓòÉΓòÉ
  2140.  
  2141. You can create or change a Communications Manager configuration using the 
  2142. Configuration, Installation, and Distribution (CID) response files. You can use 
  2143. the response files to configure almost all of the Communications Manager 
  2144. configuration parameters.  The CMRECORD utility creates a response file from a 
  2145. configuration.  The model configuration can be a configuration that you want to 
  2146. upgrade or a configuration that was created with CMSETUP.  You can 
  2147. automatically create a configuration on a workstation with CMSETUP using the 
  2148. response files. 
  2149.  
  2150. Creating configurations with CID is generally the responsibility of the network 
  2151. administrator. 
  2152.  
  2153.  
  2154. ΓòÉΓòÉΓòÉ 8.5.6. Editing the .NDF File ΓòÉΓòÉΓòÉ
  2155.  
  2156. The node definitions file (.NDF) allows you to change your node configuration 
  2157. using a text editor.  This is useful when you want to: 
  2158.  
  2159. o Make a quick change to a verb parameter 
  2160.  
  2161. o Duplicate an .NDF file quickly 
  2162.  
  2163. o View the configuration verbs 
  2164.  
  2165. o Specify configuration verbs and parameters not supported by CMSETUP 
  2166.  
  2167.   Note:  Only experienced Communications Manager users should modify the .NDF 
  2168.   file. 
  2169.  
  2170.  
  2171. ΓòÉΓòÉΓòÉ 8.5.7. Using the Configuration Program ΓòÉΓòÉΓòÉ
  2172.  
  2173. There are three ways to use the Communications Manager configuration windows. 
  2174. Select one of the following items for more information about using these 
  2175. windows. 
  2176.  
  2177. o Default configuration 
  2178. o Advanced configuration 
  2179. o Communications Manager configuration list 
  2180.  
  2181.  
  2182. ΓòÉΓòÉΓòÉ 8.5.8. Default Configuration ΓòÉΓòÉΓòÉ
  2183.  
  2184. Default configuration is limited to configuring the following frequently-used 
  2185. scenarios: 
  2186.  
  2187. o 3270 emulation with LAN, SDLC or coaxial connection 
  2188. o 5250 emulation with LAN, SDLC or twinaxial connection 
  2189.  
  2190. When you use default configuration, you are required to enter the minimum 
  2191. number of parameters in each window; Communications Manager supplies defaults 
  2192. for all other values. 
  2193.  
  2194.  
  2195. ΓòÉΓòÉΓòÉ 8.5.9. Advanced Configuration ΓòÉΓòÉΓòÉ
  2196.  
  2197. Advanced configuration allows you to configure using all of the Communications 
  2198. Manager configuration windows.  If you use advanced configuration, you will 
  2199. have access to virtually all of the Communications Manager configuration 
  2200. parameters. 
  2201.  
  2202.  
  2203. ΓòÉΓòÉΓòÉ 8.5.10. Communications Manager Configuration List ΓòÉΓòÉΓòÉ
  2204.  
  2205. The Communications Manager configuration list is a list of all Communications 
  2206. Manager profiles and features.  If you are familiar with the configuration 
  2207. process, you can use this list to save time; however, Communications Manager 
  2208. does not direct you to the menus that are necessary for your particular 
  2209. scenario. 
  2210.  
  2211.  
  2212. ΓòÉΓòÉΓòÉ 8.5.11. Verifying Configuration Files ΓòÉΓòÉΓòÉ
  2213.  
  2214. When you close the Configuration Definition window, a configuration 
  2215. verification is performed.  The Options choice on the menu bar provides an 
  2216. option to turn automatic verification off; however, if the configuration is not 
  2217. verified, Communications Manager will not be able to use it at a later time. 
  2218.  
  2219. Bypassing automatic verification could be useful if, for example, you find that 
  2220. you do not have all of the necessary information to configure all the required 
  2221. profiles at that time.  When the information is available, you can restart the 
  2222. configuration program, make the appropriate modifications, and then perform the 
  2223. verification. 
  2224.  
  2225.  
  2226. ΓòÉΓòÉΓòÉ 8.5.12. Copying Configuration Profiles ΓòÉΓòÉΓòÉ
  2227.  
  2228. Communications Manager/2 does not provide a facility to copy profiles 
  2229. selectively from one configuration to another. Instead, you can generate CID 
  2230. response files and combine their feature definitions. 
  2231.  
  2232.  
  2233. ΓòÉΓòÉΓòÉ 8.5.13. Other Configuration Concerns ΓòÉΓòÉΓòÉ
  2234.  
  2235. Be careful when specifying the LU local/NAU address for terminal emulators. 
  2236. Communications Manager in Extended Services and Extended Edition ensured a 
  2237. unique address for this field; this is no longer the case because of enhanced 
  2238. multiple PU support. 
  2239.  
  2240. Because you can now have multiple host links, you can also have multiples of 
  2241. the same NAU address.  Communications Manager does not reject multiples of the 
  2242. same NAU address, even for the same host link, and only one emulator session 
  2243. can be active for one NAU address for any host. 
  2244.  
  2245.  
  2246. ΓòÉΓòÉΓòÉ 8.6. Configuration, Installation, and Distribution (CID) ΓòÉΓòÉΓòÉ
  2247.  
  2248. Configuration, Installation, and Distribution (CID) allows several forms of 
  2249. user involvement in the CID process.  They are: 
  2250.  
  2251. Attended installation 
  2252.    Someone with product knowledge is present and can respond to various prompts 
  2253.    during installation and configuration. 
  2254.  
  2255. Lightly attended installation 
  2256.    Someone is present, but is only required to start the installation, insert 
  2257.    diskettes, and respond to simple prompts. 
  2258.  
  2259. Unattended installation 
  2260.    No user involvement is required. 
  2261. For more information on CID, refer to the Response File Reference online 
  2262. document. 
  2263.  
  2264. Select an item below for more CID information. 
  2265.  
  2266. o Model configuration 
  2267. o User response files 
  2268. o Functions not provided by CID 
  2269. o General comments 
  2270.  
  2271.  
  2272. ΓòÉΓòÉΓòÉ 8.6.1. Model Configuration ΓòÉΓòÉΓòÉ
  2273.  
  2274. To create a Communications Manager model configuration on the file server, do 
  2275. one of the following: 
  2276.  
  2277. o Copy a configuration from one of the distributed workstations 
  2278.  
  2279. o Create a new configuration on the file server 
  2280.  
  2281. If you are creating the configuration on the file server, then proceed with 
  2282. configuration of a 3270 emulation session over a token-ring network.  Use 
  2283. exactly the same setups as if you were on the distributed workstation, except 
  2284. for the following: 
  2285.  
  2286. o Select a suitable name for the configuration; for example: 
  2287.  
  2288.           MYMODEL or MOD3270
  2289.  
  2290. o When prompted by CMSETUP with the pop-up window, "Will this configuration be 
  2291.   used for this workstation?", select NO.  This causes CMSETUP to skip the 
  2292.   steps related to installing components, using this configuration, on the file 
  2293.   server. 
  2294.  
  2295. o During the configuration, when you are required to provide values such as 
  2296.   LOCAL_CP_NAME, enter the values for one. 
  2297.  
  2298.  
  2299. ΓòÉΓòÉΓòÉ 8.6.2. User Response Files ΓòÉΓòÉΓòÉ
  2300.  
  2301. The following methods can be used to create user response files: 
  2302.  
  2303. o Edit the sample new installation response file provided with Communications 
  2304.   Manager.  You can find this sample on the Network Administrator Diskette. 
  2305.  
  2306. o Use the Communications Manager CMRECORD function to convert a configuration 
  2307.   into a response file, then edit the result to customize the file. 
  2308.  
  2309. o Use an editor to create a response file from scratch. This is not 
  2310.   recommended, as the other options create files with records in the correct 
  2311.   syntax, which saves time and increases the probability of the file being 
  2312.   error free. 
  2313.  
  2314.  
  2315. ΓòÉΓòÉΓòÉ 8.6.3. General Comments ΓòÉΓòÉΓòÉ
  2316.  
  2317. Use of a model configuration versus response file only 
  2318.  
  2319. Network administrators can provide almost all configuration information in 
  2320. either a response file, a configuration file set or a mixture of both. 
  2321.  
  2322. For example, a network administrator may wish to consider using only response 
  2323. files to define configuration information.  This is possible except for the 
  2324. following function, which cannot be specified in a response file: 
  2325.  
  2326. o Keyboard remapping 
  2327.  
  2328. Note:  The Keyboard remapping must be configured on an individual workstation 
  2329. by copying onto the workstation the appropriate configuration files. 
  2330.  
  2331. o Creating keyboard definitions in a response file requires care. 
  2332.  
  2333.   A keyboard record in a configuration file is not directly linked to a COUNTRY 
  2334.   profile.  Therefore, CMRECORD cannot automatically create correct values for 
  2335.   the AT_KEYBOARD, ENHANCED_KEYBOARD, and 106_ENHANCED_KEYBOARD (DBCS only) 
  2336.   records. 
  2337.  
  2338.   To overcome this, CMRECORD outputs the keyboard records without any COUNTRY 
  2339.   fields.  The response file processor (CMSETUP /R) considers COUNTRY to be an 
  2340.   optional field. When CMSETUP /R is processing a response file, if the COUNTRY 
  2341.   field is not specified, CMSETUP /R will examine the NAME filed and take the 
  2342.   following action: 
  2343.  
  2344.    - If the NAME is a known name, for example ACSCENUS, then Communications 
  2345.      Manager will use the appropriate model keyboard. 
  2346.  
  2347.    - If the NAME is a user-defined name (for example, MYKEYBD), then 
  2348.      Communications Manager will determine what keyboard is defined to OS/2 via 
  2349.      CONFIG.SYS and use the appropriate country's model keyboard to create the 
  2350.      keyboard record. 
  2351.  
  2352.  
  2353. ΓòÉΓòÉΓòÉ 8.6.4. Functions not provided by CID ΓòÉΓòÉΓòÉ
  2354.  
  2355. The following functions are not provided by CID: 
  2356.  
  2357. o Keywords which install by feature, without configuration 
  2358.  
  2359.   It is not possible to specify just a record keyboard in a response file, with 
  2360.   no field values and have the CID process install that feature.  At a minimum, 
  2361.   a NAME field keyword must be specified on any record keyword 
  2362.  
  2363. o Keywords to add, remove or change keylock passwords 
  2364.  
  2365.   Keylock password is provided on the CMSETUP /R command via the /KL parameter 
  2366.  
  2367. o Updating multiple configurations in a single job 
  2368.  
  2369.   Only one configuration can be updated per CID installation. Multiple CID 
  2370.   installations with CMUPDATETYPE=4 (no installation) can be used to update 
  2371.   multiple configurations on a workstation 
  2372.  
  2373.  
  2374. ΓòÉΓòÉΓòÉ 8.7. Command Enhancements ΓòÉΓòÉΓòÉ
  2375.  
  2376. Several commands are available from an OS/2 window or full screen session.  In 
  2377. general, you do not need to use line commands for Communications Manager. 
  2378. Virtually all of the Communications Manager functions are now accessible from 
  2379. OS/2 Presentation Manager windows.  There are times, however, when it can be 
  2380. useful to perform a function under program control. 
  2381.  
  2382. For more information, refer to the Command Reference. 
  2383.  
  2384.  
  2385. ΓòÉΓòÉΓòÉ 8.8. ACDI Redirection Upgrade Restriction ΓòÉΓòÉΓòÉ
  2386.  
  2387. If you upgrade an existing configuration that includes Asynchronous 
  2388. Communications Device Interface (ACDI) redirection from OS/2 EE 1.30.2 or 
  2389. Extended Services, your ACDI redirection configuration will not be upgraded. 
  2390. Everything else in your existing configuration is upgraded, including the ACDI 
  2391. APIs.  To include ACDI redirection, you will need to modify your upgraded 
  2392. configuration. 
  2393.  
  2394.  
  2395. ΓòÉΓòÉΓòÉ 9. Productivity Aids (Applets) ΓòÉΓòÉΓòÉ
  2396.  
  2397. A variety of productivity aids are included with Communications Manager. You 
  2398. should be aware, however, that these programs are not a formal part of 
  2399. Communications Manager and are not supported by IBM. 
  2400.  
  2401. A complete list of these productivity aids is contained on disk 1 of the 
  2402. Productivity Aids diskettes.  For information on accessing these productivity 
  2403. aids, refer to the online README file. 
  2404.  
  2405.  
  2406. ΓòÉΓòÉΓòÉ 10. Restrictions ΓòÉΓòÉΓòÉ
  2407.  
  2408. The following restrictions apply to this release of Communications Manager. 
  2409. Refer to the README file for the latest updates. 
  2410.  
  2411. Gateway Restrictions 
  2412.  
  2413. o Single focal point 
  2414.  
  2415.   Although Communications Manager can maintain multiple SSCP-PU sessions, only 
  2416.   one host system can be used as an active focal point for sending alerts. 
  2417.   This link is specified with the HOST_FP_LINK_NAME parameter of the 
  2418.   DEFINE_LOCAL_CP record in the .NDF file.  The link for the focal point must 
  2419.   be using the implicit PU with the same name as the local CP. 
  2420.  
  2421. o Single host entry point 
  2422.  
  2423.   A Communications Manager node only accepts network management requests 
  2424.   (NMVTs) from a PU 2 host that are addressed to the PU with the same name as 
  2425.   the CP. 
  2426.  
  2427. o One PU per host/adapter/address 
  2428.  
  2429.   The Communications Manager node can only have one link to another partner 
  2430.   over a given source adapter/target address pair.  The only way to define an 
  2431.   additional PU is to define an additional link.  Therefore, it is not possible 
  2432.   to have multiple PUs to the same host unless a different local adapter or 
  2433.   remote address is specified. 
  2434.  
  2435.   Note:  In addition to the obvious solution of using multiple adapters, 
  2436.   another possibility is to define a different target SAP address.  VTAM allows 
  2437.   you to specify a source SAPADDR parameter on the PU definition if you are 
  2438.   connected by an ICA.  You can configure the local SAP in the LAN DLC Adapter 
  2439.   profile and the target SAP in the SNA Connections Link Profile. 
  2440.  
  2441.  
  2442. ΓòÉΓòÉΓòÉ 11. Bibliography ΓòÉΓòÉΓòÉ
  2443.  
  2444. The bibliography for Communications Manager/2 describes both online and printed 
  2445. sources of information that can be useful when planning for or using 
  2446. Communications Manager. 
  2447.  
  2448. o Publications Ordering Information 
  2449.  
  2450. o Communications Manager/2 Product Package Publications 
  2451.  
  2452. o Communications Manager/2 Administrator's Package Publications 
  2453.  
  2454. o Communications Manager/2 Programming Publications 
  2455.  
  2456. o Related Local Area Network Publications 
  2457.  
  2458. o Integrated Services Digital Network Publications 
  2459.  
  2460. o SNA Session Level Data Confidentiality Publications 
  2461.  
  2462. o OS/2 Publications 
  2463.  
  2464. o Related IBM AS/400 Host Publications 
  2465.  
  2466. o Related 3270 Host Communications Publications 
  2467.  
  2468. o Related Realtime Interface Co-Processor Publications 
  2469.  
  2470. o Related X.25 Packet-Switching Data Networks Publications 
  2471.  
  2472. o Systems Application Architecture (SAA) Publications 
  2473.  
  2474.  
  2475. ΓòÉΓòÉΓòÉ 11.1. Publications Ordering Information ΓòÉΓòÉΓòÉ
  2476.  
  2477. Part numbers and order numbers for IBM publications are presented in the 
  2478. following way: 
  2479.  
  2480. o If only one part number or order number follows a publication title, that 
  2481.   part number or order number is the worldwide part number; for example: 
  2482.  
  2483.    IBM LAN Asynchronous Connection Server Function and Connectivity Guidelines 
  2484.    (GA27-3917) 
  2485.  
  2486. o If a publication has a U.S. version different from the worldwide English 
  2487.   version, two part numbers or order numbers are given in the following 
  2488.   example: 
  2489.  
  2490.    IBM X.25 Interface Co-Processor/2: Technical Reference (16F1879 (U.S.); 
  2491.    07F3180). 
  2492.  
  2493. o If a publication has both a part number and an order number, the numbers are 
  2494.   given as in the following example: 
  2495.  
  2496.    IBM Local Area Network Technical Reference (25F7688, P/N SC30-3383-03). 
  2497.  
  2498. Note:  Four publications have order numbers listed and can be ordered 
  2499. separately.  These books are at the Communications Manager/2 Version 1.0 level 
  2500. and have not been updated for this release. 
  2501.  
  2502. To order Communications Manager/2 or OS/2 publications, use the toll-free 
  2503. number: 800-426-7282. The publication part number (P/N) is required when 
  2504. ordering through this phone number. Contact your IBM authorized dealer or your 
  2505. IBM marketing representative for information about ordering any of the 
  2506. publications listed in this bibliography. 
  2507.  
  2508.  
  2509. ΓòÉΓòÉΓòÉ 11.2. Communications Manager/2 Basic Product Package Books ΓòÉΓòÉΓòÉ
  2510.  
  2511. The following list encompasses all of the hardcopy and online publications in 
  2512. the Communications Manager library.  The words "IBM Communications Manager/2" 
  2513. are actually part of the title of each book; however, in this list, those words 
  2514. are omitted. 
  2515.  
  2516. o Workstation Installation and Configuration Guide, SC31-7169-01 
  2517.  
  2518. o Quick Installation, SX75-0085-01 
  2519.  
  2520. o User's Guide, SC31-7068-01 
  2521.  
  2522. o Command Reference (online) 
  2523.  
  2524. o Overview (online) 
  2525.  
  2526. o Glossary (online) 
  2527.  
  2528. o Response File Reference (online) 
  2529.  
  2530. o Service Point Application Router and Remote Operations Service Guide (online) 
  2531.  
  2532. o Message Reference (online) 
  2533.  
  2534. o Problem Determination Guide (online) 
  2535.  
  2536. The following publication is available as a separately orderable publication. 
  2537.  
  2538. o Information and Planning Guide, SC31-7007-01 
  2539.  
  2540.  
  2541. ΓòÉΓòÉΓòÉ 11.3. Communications Manager/2 Administrator's Package Books ΓòÉΓòÉΓòÉ
  2542.  
  2543. The following list encompasses all of the books in the Communications Manager/2 
  2544. Administrator's Package.  The words "IBM Communications Manager/2" are actually 
  2545. part of the title of each book; however, in this list, those words are omitted. 
  2546.  
  2547. The following books provide advanced planning and installation information for 
  2548. Communications Manager: 
  2549.  
  2550. o Network Administration and Subsystem Management Guide, SC31-6168-01 
  2551.  
  2552. o Scenarios, SC31-6174-01 
  2553.  
  2554. o Host Connection Reference, SC31-6170-01 
  2555.  
  2556. o Host Print Guide, SC31-7145-00 
  2557.  
  2558.  
  2559. ΓòÉΓòÉΓòÉ 11.4. Communications Manager/2 Programming Books ΓòÉΓòÉΓòÉ
  2560.  
  2561. The following list encompasses all the programming books in the Communications 
  2562. Manager library.  The words "IBM Communications Manager/2" are actually part of 
  2563. the title of each book; however, in this list, those words are omitted. 
  2564.  
  2565. These publications are provided in BOOK and LISTPS format on the Communications 
  2566. Manager/2 Version 1.1 CD-ROM. 
  2567.  
  2568. The following books provide Communications Manager application programming 
  2569. interface (API) programming information for creating and maintaining 
  2570. Communications Manager programs: 
  2571.  
  2572. o Application Programming Guide 
  2573.  
  2574. o ACDI Programming Reference, SC31-6161 
  2575.  
  2576. o APPC Programming Guide and Reference 
  2577.  
  2578. o Conventional LU Application Programming Reference 
  2579.  
  2580. o ECF Server-Requester Programming Interface (SRPI) Reference, SC31-6165 
  2581.  
  2582. o EHLLAPI Programming Reference 
  2583.  
  2584. o ISDN Connection Management Interface (CMI) Programming Reference 
  2585.  
  2586. o ISDN Port Connection Manager (PCM) Programming Reference 
  2587.  
  2588. o Realtime Interface Co-Processor Device Driver Programming Reference, 
  2589.   SC31-6164 
  2590.  
  2591. o System Management Programming Reference 
  2592.  
  2593. o X.25 Programming Reference, SC31-6167 
  2594.  
  2595.  
  2596. ΓòÉΓòÉΓòÉ <hidden> Quick Installation, SX75-0085-01 ΓòÉΓòÉΓòÉ
  2597.  
  2598. Quick Installation, SX75-0085-01; P/N 79G0460 
  2599.  
  2600. This card provides you with a very brief set of instructions on how to start 
  2601. the installation of Communications Manager.  It is intended primarily for those 
  2602. who want to accept most or all of the preselected choices during installation. 
  2603. Quick Installation provides only limited instructions to get you started.  If 
  2604. you want more detailed information about installing Communications Manager, 
  2605. refer to Workstation Installation and Configuration Guide. 
  2606.  
  2607.  
  2608. ΓòÉΓòÉΓòÉ <hidden> * @R2c ΓòÉΓòÉΓòÉ
  2609.  
  2610.   width=50% height=100%.User's Guide, SC31-6108-01 
  2611.  
  2612. User's Guide, SC31-6108-01; P/N 79G0456 
  2613.  
  2614. This book provides information necessary to accomplish basic communication 
  2615. tasks using Communications Manager. For example, this volume contains 
  2616. information and procedures for starting and stopping Communications Manager, 
  2617. using the clipboard to mark and copy data from one application to another, 
  2618. using 3270 and 5250 emulation, transferring files, and changing the current 
  2619. keyboard layout. 
  2620.  
  2621.  
  2622. ΓòÉΓòÉΓòÉ <hidden> Host Print Guide, SC31-7145 ΓòÉΓòÉΓòÉ
  2623.  
  2624. Host Print Guide, SC31-7145; P/N 79G0453 
  2625.  
  2626. This book describes how to use the functions in Communications Manager Host 
  2627. Print for both AS/400 and 3270 printing.  It tells how to configure for 
  2628. printing ,meet special printing needs, and solve printing problems. 
  2629.  
  2630.  
  2631. ΓòÉΓòÉΓòÉ <hidden> Problem Determination Guide ΓòÉΓòÉΓòÉ
  2632.  
  2633. Problem Determination Guide 
  2634.  
  2635. This book provides online documentation for problem determination procedures 
  2636. using FFST/2, trace and dump services, diagnostic tools, sense data, and OS/2 
  2637. request codes. 
  2638.  
  2639.  
  2640. ΓòÉΓòÉΓòÉ <hidden> Command Reference ΓòÉΓòÉΓòÉ
  2641.  
  2642. Command Reference 
  2643.  
  2644. This online document lists the Communications Manager commands and their syntax 
  2645. diagrams.  It also describes Communications Manager device drivers. 
  2646.  
  2647.  
  2648. ΓòÉΓòÉΓòÉ <hidden> Glossary ΓòÉΓòÉΓòÉ
  2649.  
  2650. Glossary 
  2651.  
  2652. This online book defines technical terms and acronyms that are used throughout 
  2653. the Communications Manager program and publications. 
  2654.  
  2655.  
  2656. ΓòÉΓòÉΓòÉ <hidden> Information and Planning Guide, SC31-7007-01 ΓòÉΓòÉΓòÉ
  2657.  
  2658. Information and Planning Guide, SC31-7007-01; P/N 79G0459 
  2659.  
  2660. This book provides an overview of Communications Manager, including 
  2661. descriptions of new and enhanced functions and productivity aids, information 
  2662. on the administration and use of Communications Manager, and system 
  2663. requirements.  This book also provides technical advice on performance and 
  2664. coexistence considerations, planning new installations, and migrating from 
  2665. previous releases. 
  2666.  
  2667.  
  2668. ΓòÉΓòÉΓòÉ <hidden> Overview ΓòÉΓòÉΓòÉ
  2669.  
  2670. Overview 
  2671.  
  2672. This online document provides a comprehensive view of Communications Manager. 
  2673. It includes a description of configuration, services, emulator functions, 
  2674. application programming interfaces, and a complete bibliography of 
  2675. Communications Manager documentation and related publications. 
  2676.  
  2677.  
  2678. ΓòÉΓòÉΓòÉ <hidden> Network Administration and Subsystem Management Guide, ΓòÉΓòÉΓòÉ
  2679.  
  2680. Network Administration and Subsystem Management Guide, SC31-6168-01; P/N 
  2681. 79G0452 
  2682.  
  2683. This book provides an overview of Communications Manager functions and the 
  2684. steps required to create the Communications Manager configurations for the 
  2685. workstations you support.  This book also contains configuration worksheets. 
  2686.  
  2687.  
  2688. ΓòÉΓòÉΓòÉ <hidden> Response File Reference ΓòÉΓòÉΓòÉ
  2689.  
  2690. Response File Reference 
  2691.  
  2692. This online document contains information on how to create response files and 
  2693. use them to configure Communications Manager remotely.  It also lists all of 
  2694. the response file keywords and explains how to upgrade Extended Services 
  2695. response files to Communications Manager response files. 
  2696.  
  2697.  
  2698. ΓòÉΓòÉΓòÉ <hidden> Scenarios, SC31-6174-01 ΓòÉΓòÉΓòÉ
  2699.  
  2700. Scenarios, SC31-6174-01; P/N 79G0458 
  2701.  
  2702. This book contains sample scenarios with steps to install and configure several 
  2703. different kinds of networks with attached workstations. 
  2704.  
  2705.  
  2706. ΓòÉΓòÉΓòÉ <hidden> Workstation Installation and Configuration Guide, SC31-7169 ΓòÉΓòÉΓòÉ
  2707.  
  2708. Workstation Installation and Configuration Guide, SC31-7169; P/N 79G0296 
  2709.  
  2710. This book provides the basic information to install Communications Manager and 
  2711. to configure it for various connections and features. This book also contains 
  2712. information about using a response file for installation and about changing a 
  2713. configuration.  Some advanced user tasks, such as how to use the keylock 
  2714. function to protect configuration files, are described here. 
  2715.  
  2716.  
  2717. ΓòÉΓòÉΓòÉ <hidden> Host Connection Reference, SC31-6170-01 ΓòÉΓòÉΓòÉ
  2718.  
  2719. Host Connection Reference, SC31-6170-01; P/N 79G0457 
  2720.  
  2721. This book contains parameter matching and sample system generations for OS/2 
  2722. connections to S/370 and Application System/400* (AS/400*) hosts. 
  2723.  
  2724. * Trademark of IBM 
  2725.  
  2726.  
  2727. ΓòÉΓòÉΓòÉ <hidden> Service Point Application Router and Remote Operations Service Guide, SC31-7006 ΓòÉΓòÉΓòÉ
  2728.  
  2729. Service Point Application Router and Remote Operations Service Guide 
  2730.  
  2731. This is an online book that contains guidance and reference information for 
  2732. using two Communications Manager functions, Service Point Application Router 
  2733. and Remote Operations Service, to handle network management commands directed 
  2734. to a workstation by a NetView operator or application program. 
  2735.  
  2736.  
  2737. ΓòÉΓòÉΓòÉ <hidden> Message Reference, ΓòÉΓòÉΓòÉ
  2738.  
  2739. Message Reference 
  2740.  
  2741. This online book contains the text, explanations, and suggested actions for all 
  2742. Communications Manager messages.  This document is also available online. 
  2743.  
  2744.  
  2745. ΓòÉΓòÉΓòÉ <hidden> Application Programming Guide ΓòÉΓòÉΓòÉ
  2746.  
  2747. Application Programming Guide 
  2748.  
  2749. This book describes application program development for Communications Manager. 
  2750. It is the starting point for writing application programs that use any of the 
  2751. Communications Manager application programming interfaces (APIs) and contains 
  2752. information common to all of the APIs. The Communications Manager/2 Sample 
  2753. Programs diskette, which contains sample programs, API data structures, and 
  2754. header files, is provided with this book. 
  2755.  
  2756.  
  2757. ΓòÉΓòÉΓòÉ <hidden> ACDI Programming Reference, SC31-6161 ΓòÉΓòÉΓòÉ
  2758.  
  2759. ACDI Programming Reference, SC31-6161 
  2760.  
  2761. This book introduces and defines the procedures for using the Asynchronous 
  2762. Communications Device Interface (ACDI). This book serves as a reference for 
  2763. programmers who want to use the asynchronous programming functions to create 
  2764. their own application programs using C and Macro Assembler languages. 
  2765.  
  2766.  
  2767. ΓòÉΓòÉΓòÉ <hidden> APPC Programming Guide and Reference ΓòÉΓòÉΓòÉ
  2768.  
  2769. APPC Programming Guide and Reference 
  2770.  
  2771. This book provides information necessary to create application programs in the 
  2772. C, COBOL, or Macro Assembler programming languages that use the advanced 
  2773. program-to-program communications (APPC) programming interface functions. 
  2774.  
  2775.  
  2776. ΓòÉΓòÉΓòÉ <hidden> Conventional LU Application Programming Reference ΓòÉΓòÉΓòÉ
  2777.  
  2778. Conventional LU Application Programming Reference 
  2779.  
  2780. This book provides information necessary to create application programs in the 
  2781. C, COBOL, or Macro Assembler programming languages that use the IBM OS/2 
  2782. Conventional LU Application (LUA) programming interface. 
  2783.  
  2784.  
  2785. ΓòÉΓòÉΓòÉ <hidden> ECF Server-Requester Programming Interface (SRPI) Reference, SC31-6165 ΓòÉΓòÉΓòÉ
  2786.  
  2787. ECF Server-Requester Programming Interface (SRPI) Reference, SC31-6165 
  2788.  
  2789. This book provides programmers with the information necessary to create 
  2790. requester application programs that use the Server-Requester Programming 
  2791. Interface (SRPI) functions in Communications Manager. 
  2792.  
  2793.  
  2794. ΓòÉΓòÉΓòÉ <hidden> EHLLAPI Programming Reference ΓòÉΓòÉΓòÉ
  2795.  
  2796. EHLLAPI Programming Reference 
  2797.  
  2798. This book defines the Emulator High-Level Language Application Programming 
  2799. Interface (EHLLAPI). Applications written to this programming interface can 
  2800. access and control the 3270 and 5250 host presentation spaces. 
  2801.  
  2802.  
  2803. ΓòÉΓòÉΓòÉ <hidden> ISDN Connection Management Interface (CMI) Programming Reference ΓòÉΓòÉΓòÉ
  2804.  
  2805. ISDN Connection Management Interface (CMI) Programming Reference 
  2806.  
  2807. This book describes how to use the integrated services digital network (ISDN) 
  2808. connection manager interface (CMI) to make a connection for user applications 
  2809. through a switched network. 
  2810.  
  2811.  
  2812. ΓòÉΓòÉΓòÉ <hidden> ISDN Port Connection Manager (PCM) Programming Reference ΓòÉΓòÉΓòÉ
  2813.  
  2814. ISDN Port Connection Manager (PCM) Programming Reference 
  2815.  
  2816. This book describes how to develop and implement a call control module (a port 
  2817. connection manager) for use in Communications Manager's switched network 
  2818. environment. 
  2819.  
  2820.  
  2821. ΓòÉΓòÉΓòÉ <hidden> Realtime Interface Co-Processor Device Driver Programming Reference, SC31-6164 ΓòÉΓòÉΓòÉ
  2822.  
  2823. Realtime Interface Co-Processor Device Driver Programming Reference, SC31-6164 
  2824.  
  2825. This book provides information for writing programs that support the Realtime 
  2826. Interface Co-Processor adapters. The dynamic link libraries, the application 
  2827. loader, and the device driver interface are discussed. 
  2828.  
  2829.  
  2830. ΓòÉΓòÉΓòÉ <hidden> System Management Programming Reference ΓòÉΓòÉΓòÉ
  2831.  
  2832. System Management Programming Reference 
  2833.  
  2834. This book provides detailed descriptions of the Advanced Peer-to-Peer 
  2835. Networking (APPN)* configuration and subsystem management verbs.  These verbs 
  2836. allow configuration and management of APPN nodes. 
  2837.  
  2838. * Trademark of IBM 
  2839.  
  2840.  
  2841. ΓòÉΓòÉΓòÉ <hidden> X.25 Programming Reference, SC31-6167 ΓòÉΓòÉΓòÉ
  2842.  
  2843. X.25 Programming Reference, SC31-6167 
  2844.  
  2845. This book provides the information necessary to create application programs in 
  2846. the C, COBOL, or Macro Assembler programming languages that use the X.25 API. 
  2847.  
  2848.  
  2849. ΓòÉΓòÉΓòÉ 11.5. Related Local Area Network Publications ΓòÉΓòÉΓòÉ
  2850.  
  2851. The following LAN publications can aid administrators in installing, 
  2852. configuring, and using LAN servers, requesters, and hardware: 
  2853.  
  2854. o IBM Local Area Network Technical Reference (25F7688, SC30-3383-03) provides 
  2855.   information for using IBM LAN adapters and software interfaces in IBM 
  2856.   Personal System/2* (PS/2*) and IBM Personal Computer AT* workstations. It is 
  2857.   intended for programmers who plan to use IBM LANs and for those who need 
  2858.   information about the correct adapters required for setting up an IBM LAN. 
  2859.  
  2860. o IBM LAN Asynchronous Connection Server Function and Connectivity Guidelines 
  2861.   (GA27-3917) provides guidelines for configuring a LAN asynchronous connection 
  2862.   server. 
  2863.  
  2864. o IBM Local Area Network Asynchronous Connection Server (SC30-3509-01) provides 
  2865.   information for network administrators who are planning and installing a LAN 
  2866.   asynchronous connection server. This book is provided with the LAN 
  2867.   asynchronous connection server product and cannot be purchased separately. 
  2868.  
  2869. o The LAN Server Version 2.0 product is described in the IBM Operating System/2 
  2870.   Local Area Network Server Version 2.0 Network Administrator Reference: 
  2871.  
  2872.    - Volume 1:  Planning and Installation (04G1032) 
  2873.    - Volume 2:  Performance Tuning (04G1033) 
  2874.    - Volume 3:  Network Administrator Tasks (04G1034) 
  2875.  
  2876. o IBM Token-Ring Network Introduction and Planning Guide (GA27-3677-03). 
  2877.  
  2878. o IBM Token-Ring Network Problem Determination Guide (SX27-3710-04). 
  2879.  
  2880. o IBM PC Network Hardware Maintenance and Service Manual (S68X-2240-03). 
  2881.  
  2882. o IBM 3174 Establishment Controller Peer Communication User's Guide 
  2883.   (GA27-3887-02). 
  2884.  
  2885. o IBM NETBIOS Application Development Guide (S68X-2270). 
  2886.  
  2887. o IEEE 802.2 Local Area Networks Standard, 802.2 Logical Link Control, 
  2888.   ANSI/IEEE Standard, October, 1985. 
  2889.  
  2890. o IEEE 802.2 Local Area Networks Standard, 802.3 Carrier Sense Multiple Access, 
  2891.   ANSI/IEEE Standard, October, 1985. 
  2892.  
  2893. o Microsoft/3Com LAN Manager Network Driver Interface Specification, Version 
  2894.   2.01, Microsoft Corporation, 3Com Corporation. 
  2895.  
  2896. o The Ethernet:  A Local Area Network, Data Link Layer and Physical Layer 
  2897.   Specifications, Digital, Intel, XEROX, Version 2.0, November 1982, Digital 
  2898.   Equipment Corporation, Intel Corporation, Xerox Corporation. 
  2899.  
  2900. * Trademark of IBM 
  2901.  
  2902.  
  2903. ΓòÉΓòÉΓòÉ 11.6. Integrated Services Digital Network Publications ΓòÉΓòÉΓòÉ
  2904.  
  2905. These publications provide information about ISDN architecture and interfaces. 
  2906.  
  2907. o IBM Lower-Layer Services Architecture:  ISDN Port Connection Manager 
  2908.   Architecture Reference (SC31-6829) defines the interface to the LSA port 
  2909.   connection manager function for ISDN call control. 
  2910.  
  2911. o IBM Integrated Services Digital Networks Circuit-Switching Signaling Control 
  2912.   Architecture Reference (SC31-6827) describes the format and sequence of 
  2913.   messages on the D channel that control the switched connection and use of the 
  2914.   B channel. 
  2915.  
  2916. o IBM Integrated Services Digital Networks Data Link Control Architecture 
  2917.   Reference (SC31-6826) contains information about ISDN data link control, 
  2918.   representing IBM's interpretation of CCITT Recommendations Q.921 and Q.922. 
  2919.  
  2920. o International Telegraph and Telephone Consultative Committee (CCITT), Support 
  2921.   of Packet Mode Terminal Equipment by ISDN. 
  2922.  
  2923.  
  2924. ΓòÉΓòÉΓòÉ 11.7. SNA Session Level Data Confidentiality Publications ΓòÉΓòÉΓòÉ
  2925.  
  2926. SNA session level data confidentiality is part of the IBM Transaction Security 
  2927. System (TSS).  You can use TSS with Communications Manager to encrypt data when 
  2928. it is transferred between a host and a workstation. Work Station Security 
  2929. Services (WSSS) is the workstation portion of TSS. WSSS provides the file 
  2930. CSUESAPI.DLL, which is used by Communications Manager/2 during file transfer of 
  2931. encrypted data. Refer to these IBM publications for more information about TSS 
  2932. and WSSS. 
  2933.  
  2934. o Transaction Security System: General Information Manual and Planning Guide 
  2935.   (GA34-2137). This publication describes the hardware and software products in 
  2936.   TSS. It also describes ways in which you can use these products to: 
  2937.  
  2938.    - Provide data confidentiality in an SNA network environment 
  2939.    - Determine data integrity 
  2940.    - Store sensitive data on portable media 
  2941.    - Process financial PINs 
  2942.    - Use public-key functions 
  2943.  
  2944.   This manual also provides planning and site preparation information for TSS. 
  2945.  
  2946. o Transaction Security System: Programming Reference:  Volume 1, Access Control 
  2947.   and DES Cryptography (SC31-2934). This book provides guidance and reference 
  2948.   information for the Transaction Security System security application program 
  2949.   interface (API). The book is intended for system analysts who are responsible 
  2950.   for designing programs that use the TSS hardware and software. Application 
  2951.   programmers who are responsible for writing application programs that use the 
  2952.   security API should also use this book. 
  2953.  
  2954. o Workstation Security Services Installation and Operating Guide (SA34-2141). 
  2955.   This publication item is a kit that includes a manual, tabs, binder, and 
  2956.   diskette holders. The manual tells how to install the 4754 and 4755 
  2957.   cryptographic adapters. It also tells how to install and use the various Work 
  2958.   Station Security Services utilities, including the hardware initialization 
  2959.   utility and the software configuration utility. Additional information is 
  2960.   provided about DOS support, OS/2 support, and problem determination 
  2961.   procedures. 
  2962.  
  2963.  
  2964. ΓòÉΓòÉΓòÉ 11.8. OS/2 Publications ΓòÉΓòÉΓòÉ
  2965.  
  2966. If your operating system is OS/2, you can use the publications in the following 
  2967. sections. If your operating system is manufactured by someone other than IBM, 
  2968. you can use the documentation supplied with your base operating system. 
  2969.  
  2970. o OS/2 2.0 Publications 
  2971.  
  2972. o Other OS/2 Publications 
  2973.  
  2974. o Procedures Language 2/REXX Publications 
  2975.  
  2976. o General Information 
  2977.  
  2978.  
  2979. ΓòÉΓòÉΓòÉ <hidden> OS/2 2.0 Publications ΓòÉΓòÉΓòÉ
  2980.  
  2981. If your operating system is IBM OS/2 2.0, you can use the following related 
  2982. publications: 
  2983.  
  2984. o IBM OS/2 Technical Library (10G3356) 
  2985.  
  2986. o IBM OS/2 2.0 Command Reference (S10G-6313) 
  2987.  
  2988. o IBM Application Design Guide (10G6260) 
  2989.  
  2990. o IBM Programming Guide, Volume 1 (10G6261) 
  2991.  
  2992. o IBM Programming Guide, Volume 2 (10G6494) 
  2993.  
  2994. o IBM Programming Guide, Volume 3 (10G6495) 
  2995.  
  2996. o IBM Control Program Programming Reference (10G6263) 
  2997.  
  2998. o IBM Presentation Manager Programming Reference, Volume 1 (10G6264) 
  2999.  
  3000. o IBM Presentation Manager Programming Reference, Volume 2 (10G6265) 
  3001.  
  3002. o IBM Presentation Manager Programming Reference, Volume 3 (10G6272) 
  3003.  
  3004. o IBM Information Presentation Facility Guide and Reference (10G6262) 
  3005.  
  3006. o IBM System Object Model Guide and Reference (10G6309) 
  3007.  
  3008. o IBM Physical Device Driver Reference (10G6266) 
  3009.  
  3010. o IBM Virtual Device Driver Reference (10G6310) 
  3011.  
  3012. o IBM Presentation Driver Reference (10G6267) 
  3013.  
  3014.  
  3015. ΓòÉΓòÉΓòÉ <hidden> Other OS/2 Publications ΓòÉΓòÉΓòÉ
  3016.  
  3017. If your operating system is IBM OS/2 Version 1.30.2, you can use the following 
  3018. related publications: 
  3019.  
  3020. o IBM Operating System/2 Standard Edition Getting Started 
  3021.  
  3022. o IBM Operating System/2 Standard Edition Using Advanced Features 
  3023.  
  3024. o OS/2 Programming Tools and Information Version 1.3 (6024929) (referred to as 
  3025.   Programming Tools and Information) contains books which describe programming 
  3026.   concepts for developing applications for OS/2 Standard Edition. Code examples 
  3027.   and procedures are described to show the application developer how to use an 
  3028.   API for developing source code. An installation card is included to guide the 
  3029.   application developer in installing the toolkit. The following books are 
  3030.   included: 
  3031.  
  3032.    - Programming Overview (S91F9258) 
  3033.  
  3034.    - Programming Guide (S91F9259) 
  3035.  
  3036.    - Control Program Programming Reference (S91F9260) 
  3037.  
  3038.    - Presentation Manager Programming Reference, Vol. 1 (S91F9261) 
  3039.  
  3040.    - Presentation Manager Programming Reference, Vol. 2 (S91F9262) 
  3041.  
  3042.    - I/O Subsystems and Device Support, Vol. 1: Device Drivers (S91F9263) 
  3043.  
  3044.    - Building Programs (S91F9264) 
  3045.  
  3046.    - Presentation Manager C/2 Bindings Reference (S91F9265) 
  3047.  
  3048.    - I/O Subsystems and Device Support, Vol. 2: Driver Interfaces (S91F9266) 
  3049.  
  3050.    - FORTRAN/2 Bindings Reference (S91F9267) 
  3051.  
  3052.    - COBOL/2 Binding Reference (S91F9268) 
  3053.  
  3054.    - Presentation Manager Macro Assembler/2 Bindings Reference (S91F9269) 
  3055.  
  3056.    - Dialog Manager and Dialog Tag Summary Reference (S91F9270 ) 
  3057.  
  3058.    - Dialog Tag Language Guide and Reference (S91F9271) 
  3059.  
  3060.    - Procedures Language/2 REXX Programming Reference (S91F9272) 
  3061.  
  3062.    - Dialog Manager Guide and Reference (S91F9273) 
  3063.  
  3064.    - Master Index (S12F9826) 
  3065.  
  3066.  
  3067. ΓòÉΓòÉΓòÉ <hidden> Procedures Language 2/REXX Publications ΓòÉΓòÉΓòÉ
  3068.  
  3069. The following Procedures Language 2/REXX publications are available: 
  3070.  
  3071. o OS/2 2.0 Procedures Language 2/REXX Reference (S10G-6268) 
  3072.  
  3073. o OS/2 2.0 Procedures Language 2/REXX User's Guide (S10G-6269) 
  3074.  
  3075.  
  3076. ΓòÉΓòÉΓòÉ <hidden> General Information ΓòÉΓòÉΓòÉ
  3077.  
  3078. The following information sources can help you understand the products 
  3079. available from IBM: 
  3080.  
  3081. o Catalog of IBM Education (G320-1244-38, U.S. only; GN21-4412) 
  3082.  
  3083. o Software Directory (GB21-9949-28, U.S. only; GN20-3025) 
  3084.  
  3085.  
  3086. ΓòÉΓòÉΓòÉ 11.9. Related IBM AS/400 Host Publications ΓòÉΓòÉΓòÉ
  3087.  
  3088. The following information lists the related publications for Communications 
  3089. Manager communications with an AS/400 host. 
  3090.  
  3091. o AS/400 Publications 
  3092.  
  3093. o 5250 Emulation Publications 
  3094.  
  3095. o PC Support/400 Publications 
  3096.  
  3097.  
  3098. ΓòÉΓòÉΓòÉ <hidden> AS/400 Publications ΓòÉΓòÉΓòÉ
  3099.  
  3100. For information about the IBM AS/400 host library, refer to AS/400 Publications 
  3101. Guide (GC41-9678). 
  3102.  
  3103.  
  3104. ΓòÉΓòÉΓòÉ <hidden> 5250 Emulation Publications ΓòÉΓòÉΓòÉ
  3105.  
  3106. The following publications can help users understand 5250 emulation with 
  3107. Communications Manager/2: 
  3108.  
  3109. o IBM 5250 Information Display System Planning and Site Preparation Guide 
  3110.   (GA21-9337-08) 
  3111.  
  3112. o IBM 5251 Display Station Models 1 and 11 5252 Dual Display Station Operator's 
  3113.   Guide (GA21-9248-03) 
  3114.  
  3115. o IBM 5251 Display Station Models 2 and 12 Operator's Guide (GA21-9323-02) 
  3116.  
  3117. o IBM 5291 Display Station Operator's Guide (GA21-9409-02) 
  3118.  
  3119. o IBM 5292 Color Display Station Models 1 and 2 Operator's Guide (GA21-9416-01) 
  3120.  
  3121.  
  3122. ΓòÉΓòÉΓòÉ <hidden> PC Support/400 Publications ΓòÉΓòÉΓòÉ
  3123.  
  3124. The following publications can help you learn how to use PC Support/400 to 
  3125. communicate with an IBM AS/400 host: 
  3126.  
  3127. o AS/400 PC Support/400: OS/2 Installation and Administration Guide Version 2.2 
  3128.   (SC41-0007) 
  3129.  
  3130. o AS/400 PC Support/400:  OS/2 Installation and Administration (PS/55) Guide 
  3131.   Version 2.2 (SC41-0009) 
  3132.  
  3133. o AS/400 PC Support/400: DOS and OS/2 Technical Reference Version 2.2 
  3134.   (SC41-8091) 
  3135.  
  3136. o AS/400 PC Support/400:  Application Program Interface Reference Version 2.2 
  3137.   (SC41-8254) 
  3138.  
  3139. o AS/400 PC Support/400:  OS/2 User's Guide Version 2.2 (SC41-8200) 
  3140.  
  3141. o AS/400 PC Support/400:  OS/2 User's Guide (PS/55) Version 2.2 (SC41-2415) 
  3142.  
  3143.  
  3144. ΓòÉΓòÉΓòÉ 11.10. Related 3270 Host Communications Publications ΓòÉΓòÉΓòÉ
  3145.  
  3146. The following publications can be helpful to communications programmers: 
  3147.  
  3148. o IBM APPC for the Personal Computer Programming Guide (SC40-0100; P/N 75X1084) 
  3149.  
  3150. o IBM Programmer's Guide to the SRPI for the PC and the 3270-PC (SC23-0959-01) 
  3151.  
  3152. o IBM 3270 PC High Level Language Application Program Interface Programmer's 
  3153.   Guide (available only with the IBM 3270 PC HLLAPI program product, 75X1087) 
  3154.  
  3155. The following host references can aid a communications system administrator who 
  3156. is consulting with host personnel during configuration: 
  3157.  
  3158. o VTAM Installation and Resource Definition Version 3 (SC23-0111-05) 
  3159.  
  3160. o ACF/VTAM Version 3 Customization (SC23-0112-03) (a component of SBOF-1584 and 
  3161.   SBOF-1583) 
  3162.  
  3163. o Enhanced Connectivity Facilities TSO/E Servers-Requesters CMS 
  3164.   Servers-Requesters Introduction Version 1 (GC23-0957-04) 
  3165.  
  3166. o Network Program Products Planning (SC27-0658-02) 
  3167.  
  3168. o Network Program Product Samples (SC30-3352-07) 
  3169.  
  3170. o Synchronous Data Link Control General Information (GA27-3093-03) 
  3171.  
  3172. o Systems Network Architecture Guide to SNA Publications (GC30-3438) 
  3173.  
  3174. o Systems Network Architecture Concepts and Products (GC30-3072-04) 
  3175.  
  3176. o Systems Network Architecture Network Product Formats (LY43-0081-01) 
  3177.  
  3178. o Systems Network Architecture Format and Protocol Reference:  Architecture 
  3179.   Logic for LU Type 6.2 (SC30-3269-03) 
  3180.  
  3181. o Systems Network Architecture:  Sessions between Logical Units (GC20-1868-02) 
  3182.  
  3183. o Systems Network Architecture Technical Overview (GC30-3073-03) 
  3184.  
  3185. o System Control Statements VSE/AF (SC33-6198-02) 
  3186.  
  3187. o 3270 Information Display System 3274 Control Unit Description and 
  3188.   Programmer's Guide (GA23-0061-02) 
  3189.  
  3190. o MVS Host Publications 
  3191.  
  3192. o VM Host Publications 
  3193.  
  3194. o Graphical Data Display Manager Publications 
  3195.  
  3196.  
  3197. ΓòÉΓòÉΓòÉ <hidden> MVS Host Publications ΓòÉΓòÉΓòÉ
  3198.  
  3199. The following publications can be used for communicating with an MVS host: 
  3200.  
  3201. o CICS/DOS/VS Version 1 Installation and Operations Guide (SC33-0070-06) 
  3202.  
  3203. o CICS/DOS/VS Version 1 Release 7 Release Guide (GC33-0130-02) 
  3204.  
  3205. o TSO/E Version 2 Guide to the Server-Requester Programming Interface 
  3206.   (SC28-1877-03) 
  3207.  
  3208. o ECF/TSO/E Servers and CMS Servers Installation Planning and Programmer's 
  3209.   Guide (SK2T-0004) 
  3210.  
  3211. o ECF Installation, Planning, and Administration Guide (SH20-9677-02) 
  3212.  
  3213.  
  3214. ΓòÉΓòÉΓòÉ <hidden> VM Host Publications ΓòÉΓòÉΓòÉ
  3215.  
  3216. The following publications can be used for communicating with a VM host: 
  3217.  
  3218. o IBM Programmers Guide to the Server-Requester Programming Interface for VM/SP 
  3219.   (SC24-5291-02) 
  3220.  
  3221. o VM/SNA NPP Samples (SC30-3309) (a component of SBOF-1584) 
  3222.  
  3223. o VM/SP Planning Guide and Reference (SC19-6201-06) 
  3224.  
  3225.  
  3226. ΓòÉΓòÉΓòÉ <hidden> Graphical Data Display Manager Publications ΓòÉΓòÉΓòÉ
  3227.  
  3228. Communications system administrators and users of the 3270 host graphics 
  3229. program Graphical Data Display Manager (GDDM*) can use the following 
  3230. publications for additional information: 
  3231.  
  3232. o GDDM Version 2 Release Guide (GC33-0320-02) 
  3233.  
  3234. o GDDM Version 2 Library Guide and Master Index (GC33-0595-01) 
  3235.  
  3236. o Introducing GDDM (GBOF-0058). This package contains: 
  3237.  
  3238.    - GDDM Version 2 General Information (GC33-0319-02) 
  3239.  
  3240.    - GDDM If you make business presentations... (GC33-0455) 
  3241.  
  3242.    - GDDM If you're an engineer... (GC33-0456) 
  3243.  
  3244. o GDDM Version 2.2 Application Programming Guide GDDM/MVS, GDDM/VM, GDDM/VSE, 
  3245.   GDDM-IMD, GDDM-PGF (SC33-0337) 
  3246.  
  3247. o GDDM Version 2 Base Programming Reference Volume 1 and 2 (SC33-0332-02) 
  3248.  
  3249. o GDDM Version 2 Base Programming Reference Summary (SX33-6053-01) 
  3250.  
  3251. o GDDM-PGF Programming Reference (SC33-0333) 
  3252.  
  3253. o GDDM-PGF Interactive Chart Utility (SC33-0328) 
  3254.  
  3255. o GDDM Better Charts Poster (GC33-0529) 
  3256.  
  3257. o GDDM-PGF Vector Symbol Editor (SC33-0330) 
  3258.  
  3259. o GDDM-PGF Version 2 Programming Reference Summary (SX33-6054) 
  3260.  
  3261. o GDDM Version 2 Installation and System Management for MVS (GC33-0321-04) 
  3262.  
  3263. o GDDM Version 2 Installation and System Management for VSE (GC33-0322-03) 
  3264.  
  3265. o GDDM Version 2 Installation and System Management for VM (GC33-0323-03) 
  3266.  
  3267. o GDDM Version 2 Performance Guide (SC33-0324) 
  3268.  
  3269. o GDDM Version 2 Messages (SC33-0325-03) 
  3270.  
  3271. o GDDM Version 2 Diagnosis and Problem Determination Guide (SC33-0326-03) 
  3272.  
  3273. o GDDM Version 2 Guide for Users (SC33-0327-02) 
  3274.  
  3275. o GDDM Image Symbol Editor (SC33-0329) 
  3276.  
  3277. o GDDM Interactive Map Definition (SC33-0338) 
  3278.  
  3279. o GDDM-GKS Programming Guide and Reference (SC33-0334) 
  3280.  
  3281. o GDDM Image View Utility (SC33-0479) 
  3282.  
  3283. o GDDM-PCLK Reference Summary (SX33-6067-01) 
  3284.  
  3285. o GDDM 2.2 Typefaces and Shading Patterns (ST33-0554) 
  3286.  
  3287. o GDDM Version 2 Licensed Program Specifications (GC33-0423-06) 
  3288.  
  3289. * Trademark of IBM 
  3290.  
  3291.  
  3292. ΓòÉΓòÉΓòÉ 11.11. Related Realtime Interface Co-Processor Publications ΓòÉΓòÉΓòÉ
  3293.  
  3294. The library for the IBM Realtime Interface Co-Processor, the IBM Realtime 
  3295. Interface Co-Processor Multiport, and the IBM Realtime Interface Co-Processor 
  3296. Multiport/2 consists of the following publications: 
  3297.  
  3298. o Realtime Interface Co-Processor Technical Reference (SC28-8006) 
  3299.  
  3300. o Realtime Interface Co-Processor Technical Reference Supplement (S15F-8872) 
  3301.  
  3302. o Realtime Interface Co-Processor Firmware Technical Reference (S33F-5336) 
  3303.  
  3304. o Realtime Interface Co-Processor Portmaster Technical Reference (S33F-5337) 
  3305.  
  3306. o Realtime Interface Co-Processor Portmaster Technical Reference Supplement 
  3307.   (SC28-8271) 
  3308.  
  3309. o Realtime Interface Co-Processor Multiport Model 2 Technical Reference 
  3310.   (S57F-0632) 
  3311.  
  3312. o Realtime Interface Co-Processor Multiport Model 2 Technical Reference 
  3313.   Supplement (SC28-8273) 
  3314.  
  3315. o OS/2 Extended Edition Version 1 Realtime Interface Co-Processor Multiport/2 
  3316.   (S01F-0300) 
  3317.  
  3318. o Realtime Interface Co-Processor:  Developer's Kit (S16F-2020).  The 
  3319.   publication with this product provides tips and techniques for system 
  3320.   programmers who are creating applications for the IBM Realtime Interface 
  3321.   Co-Processor Multiport/2 and the IBM X.25 Interface Co-Processor/2 in the 
  3322.   OS/2 program.  It describes an assortment of productivity aids, including 
  3323.   samples and debugging tools. 
  3324.  
  3325. o Realtime Interface Co-Processor:  C Language Support (SC28-8014).  The 
  3326.   publication with this product documents C high-level interfaces for the IBM 
  3327.   Realtime Interface Co-Processor Multiport/2 and the IBM X.25 Interface 
  3328.   Co-Processor/2. 
  3329.  
  3330. o Realtime Interface Co-Processor AIX Support for RISC/6000 User's Guide 
  3331.   (SC28-9596) 
  3332.  
  3333. o Realtime Interface Co-Processor and Realtime Interface Co-Processor Multiport 
  3334.   Hardware Maintenance Library (SC28-8005) 
  3335.  
  3336. o Realtime Interface Co-Processor Multiport/2 Hardware Maintenance Library for 
  3337.   6 Port Synchronous Card (S15F-8855) 
  3338.  
  3339.  
  3340. ΓòÉΓòÉΓòÉ 11.12. Related X.25 Packet-Switching Data Networks Publications ΓòÉΓòÉΓòÉ
  3341.  
  3342. The definitive X.25 reference is the CCITT (International Telegraph and 
  3343. Telephone Consultative Committee) Recommendation X.25: 
  3344.  
  3345. o Interface between Data Terminal Equipment (DTE) and Data Circuit Terminating 
  3346.   Equipment (DCE) for Terminals Operating in the Packet Mode on Public Data 
  3347.   Networks, Volume VIII, Fascicle VIII.2, Rec. X.25, Geneva (November 1980) 
  3348.  
  3349. o Data Communications Networks Interfaces, Volume VIII, Fascicle VIII.3, Rec. 
  3350.   X.20-X.32, Malaga-Torremolinos (October 1984) 
  3351.  
  3352. IBM publications for X.25 are: 
  3353.  
  3354. o X.25 1984-1988 Interface for Attaching SNA Nodes to Packet-Switched Data 
  3355.   Networks General Information Network (GA27-3761) 
  3356.  
  3357. o X.25 1984-1988 Interface for Attaching SNA Nodes to Packet-Switched Data 
  3358.   Networks Architecture Reference (SC30-3409-01) 
  3359.  
  3360. o X.25 Interface for Attaching SNA Nodes to Packet-Switched Data Networks 
  3361.   General Information (GA27-3345-02) 
  3362.  
  3363. o Tuning Considerations for SNA X.25 DTE's (GG24-1746) 
  3364.  
  3365. In addition to the literature in the preceding list, you can refer to other 
  3366. published material about packet switching and X.25.  For example, network 
  3367. providers may publish introductory material or booklets of network-specific 
  3368. information. 
  3369.  
  3370. The following publications describe the X.25 Network Control Program Packet 
  3371. Switching Interface (NPSI), which offers SNA users the ability to use 
  3372. communications facilities that support the CCITT X.25 (1980 and 1984) 
  3373. recommendations: 
  3374.  
  3375. o X.25 NCP Packet Switching Interface General Information Version 3.4 
  3376.   (GC30-3469-04) 
  3377.  
  3378. o X.25 NCP Packet Switching Interface Planning and Installation Version 5.4 
  3379.   (SC30-3470-05) 
  3380.  
  3381. o X.25 Network Control Program (NCP) Packet Switching Interface Host 
  3382.   Programming Version 3.4 (SC30-3502-03) 
  3383.  
  3384. The following publications may be needed for reference: 
  3385.  
  3386. o X.25 Interface Co-Processor/2 Technical Reference (S16F-1879, U.S.; 07F3180) 
  3387.  
  3388. o X.25 Interface Co-Processor/2 Hardware Maintenance Library (S16F-1874, U.S.; 
  3389.   07F3190; 07F3193, France; 07F3196, Germany) 
  3390.  
  3391.  
  3392. ΓòÉΓòÉΓòÉ 11.13. Systems Applications Architecture (SAA) Publications ΓòÉΓòÉΓòÉ
  3393.  
  3394. The following publications describe the requirements for SAA and its 
  3395. advantages: 
  3396.  
  3397. o Systems Application Architecture Common Communications Support Primer 
  3398.   (GC24-3483) 
  3399.  
  3400. o Systems Application Architecture Common Programming Interface Query Reference 
  3401.   (SC26-4349-03) 
  3402.  
  3403. o SAA: Common Programming Interface C Reference (SC26-4353) 
  3404.  
  3405. o SAA: Common Programming Interface C Reference (SC26-4354-02) 
  3406.  
  3407. o Systems Application Architecture Common Programming Interface Application 
  3408.   Generator Reference (SC26-4355-03) 
  3409.  
  3410. o Systems Application Architecture Common Programming Interface Dialog 
  3411.   Reference (SC26-4356-02) 
  3412.  
  3413. o Systems Application Architecture Common Programming Interface FORTRAN 
  3414.   Reference (SC26-4357-02) 
  3415.  
  3416. o Systems Application Architecture (SAA) Common Programming Interface (CPI) 
  3417.   Procedures Language Reference (SC26-4358-03) 
  3418.  
  3419. o Systems Application Architecture Common Programming Interface Presentation 
  3420.   Reference (SC26-4359-02) 
  3421.  
  3422. o SAA Writing Applications:  A Design Guide (SC26-4362) 
  3423.  
  3424. o SAA:  Common Programming Interface Communications Reference (SC26-4399) 
  3425.  
  3426. o Systems Application Architecture:  Common User Access Guide to User Interface 
  3427.   Design (SC34-4289) 
  3428.  
  3429. o Systems Application Architecture:  Common User Access Advanced Interface 
  3430.   Design Reference (SC34-4290) 
  3431.  
  3432. o IBM Systems Application Architecture:  Common Communications Support Summary 
  3433.   (GC31-6810) 
  3434.  
  3435. o SAA Applications:  A Value Guide  (G320-9803) 
  3436.